奋斗
努力

阿里云服务器部署多个SpringBoot项目端口冲突怎么解决?

云计算

这事儿不是阿里云特有的问题,本质就是:同一台服务器、同一个 IP、同一个 TCP 端口,只能有一个进程监听。多个 Spring Boot 项目都写 server.port=8080,后启动的那个大概率报:

Web server failed to start. Port 8080 was already in use.
Address already in use

处理思路很简单:先查谁占了端口,然后要么改端口,要么用 Nginx 统一转发。


1. 先查端口到底被谁占了

在服务器上执行:

ss -lntp | grep ':8080'

或者:

netstat -lntp | grep 8080

如果系统没有 netstat,可以用:

lsof -iTCP:8080 -sTCP:LISTEN

看到类似:

LISTEN 0 4096 0.0.0.0:8080 0.0.0.0:* users:(("java",pid=12345,fd=100))

说明 PID 为 12345 的 Java 进程占用了 8080。

确认进程:

ps -fp 12345

如果这个进程确实是你另一个 Spring Boot 项目,就别急着杀,说明第二个项目端口配置冲突了。

如果确认是残留进程,可以:

kill 12345

不行再:

kill -9 12345

不过 kill -9 别乱用,先确认是不是业务进程。


2. 最简单方案:每个项目配不同端口

比如项目 A:

server:
  port: 8081

项目 B:

server:
  port: 8082

启动时也可以直接用命令行覆盖:

java -jar app-a.jar --server.port=8081
java -jar app-b.jar --server.port=8082

后台启动常见写法:

nohup java -jar app-a.jar --server.port=8081 > app-a.log 2>&1 &
nohup java -jar app-b.jar --server.port=8082 > app-b.log 2>&1 &

如果用 systemd 管理,可以这样写:

[Service]
Environment=SERVER_PORT=8081
ExecStart=/usr/bin/java -jar /opt/apps/app-a.jar
Restart=always

另一个服务换成:

Environment=SERVER_PORT=8082

注意,Spring Boot 里命令行参数、系统属性、环境变量都可能覆盖配置文件里的 server.port,排查时别只看 application.yml。

可以检查启动命令:

ps -ef | grep java

看看是不是有人写了:

--server.port=8080
-Dserver.port=8080
SERVER_PORT=8080

这类配置都可能把你的 yml 配置覆盖掉。


3. 生产更推荐:Nginx 监听 80/443,后端各跑各的端口

实际项目里更常见的做法是:

公网访问 80/443
        ↓
      Nginx
        ↓
  127.0.0.1:8081  项目 A
  127.0.0.1:8082  项目 B

这样外部统一走 80 或 443,内部项目各自监听不同端口,互不影响。

Spring Boot 项目 A:

server:
  address: 127.0.0.1
  port: 8081

项目 B:

server:
  address: 127.0.0.1
  port: 8082

Nginx 按域名转发:

server {
    listen 80;
    server_name a.example.com;

    location / {
        proxy_pass http://127.0.0.1:8081/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name b.example.com;

    location / {
        proxy_pass http://127.0.0.1:8082/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

检查并重载:

nginx -t
systemctl reload nginx

如果没有域名,也可以按路径转发:

server {
    listen 80;
    server_name your-domain-or-ip;

    location /app-a/ {
        proxy_pass http://127.0.0.1:8081/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /app-b/ {
        proxy_pass http://127.0.0.1:8082/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这里有个细节:

proxy_pass http://127.0.0.1:8081/;

结尾带 / 时,/app-a/xxx 转给后端的是 /xxx。

如果写成:

proxy_pass http://127.0.0.1:8081;

结尾不带 /,后端收到的是 /app-a/xxx。

这个很容易和 Spring Boot 的 context-path 打架,部署前最好确认清楚。


4. 阿里云安全组和端口冲突不是一回事

很多人端口访问不通就去看安全组,但端口冲突是服务器本机进程之间的事。

安全组只决定外部能不能访问这个端口,不会解决两个 Java 进程抢同一个端口的问题。

如果你直接让外部访问项目端口,比如:

http://公网IP:8081
http://公网IP:8082

那需要在阿里云安全组放行 8081、8082。

如果是轻量应用服务器,还要看轻量服务器的防火墙规则。

如果是 ECS,还要看系统内部防火墙,比如:

firewall-cmd --state
firewall-cmd --list-ports

临时放行:

firewall-cmd --add-port=8081/tcp --permanent
firewall-cmd --add-port=8082/tcp --permanent
firewall-cmd --reload

Ubuntu 的话可能是:

ufw status
ufw allow 8081/tcp
ufw allow 8082/tcp

但如果用了 Nginx 统一转发,通常只放公网的 80/443 就够了,后端 8081、8082 没必要暴露到公网。


5. Docker 部署的情况

如果用 Docker,容器内部可以都监听 8080,但映射到宿主机的端口不能重复。

例如:

docker run -d --name app-a -p 8081:8080 app-a:latest
docker run -d --name app-b -p 8082:8080 app-b:latest

这样两个容器内部都可以是 8080,宿主机分别用 8081 和 8082 暴露。

但如果你用了 host 网络模式:

docker run --network host ...

那就还是共用宿主机网络命名空间,端口冲突照旧。

另外,如果 Nginx 在宿主机上,而 Spring Boot 在 Docker 容器里,Spring Boot 不要写:

server:
  address: 127.0.0.1

因为容器里的 127.0.0.1 是容器自己。一般保持默认监听即可,让 Docker 做端口映射。


6. 常见坑

比较常见的几个问题:

  1. 改了 yml 没重启服务
    改完配置要重启 Spring Boot 进程。

  2. 启动脚本里写死了 8080
    特别是 nohup、systemd、docker-compose、发布脚本里,要一起检查。

  3. 环境变量覆盖了配置
    比如服务器里设置了 SERVER_PORT=8080,会把 yml 里的端口覆盖掉。

  4. 同一个 jar 被启动两次
    发布脚本重复执行,旧进程没停,新进程又拉起来,直接冲突。

  5. Nginx 转发路径和 context-path 不匹配
    比如后端配置了:

    server:
      servlet:
        context-path: /app-a

    Nginx 转发时就要保证路径对得上。

  6. WebSocket 项目需要额外 Header
    如果项目里有 WebSocket,Nginx 里加上:

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  7. 国内地域域名访问 80/443
    如果域名解析到中国内地 ECS,通过域名访问 80/443,还要确认备案、解析、安全组这些条件。这个跟端口冲突不是一回事,但线上经常一起遇到。


简单总结:

  • 临时解决:server.port 改成不同端口。
  • 生产推荐:Spring Boot 各自监听本机端口,Nginx 统一监听 80/443,根据域名或路径转发。
  • 安全组只管外部访问,不解决本机端口冲突。
  • 排查顺序:ss/netstat/lsof 查占用 → 确认启动参数 → 改端口或改 Nginx → 检查安全组和防火墙。
未经允许不得转载:云服务器 » 阿里云服务器部署多个SpringBoot项目端口冲突怎么解决?