这事儿不是阿里云特有的问题,本质就是:同一台服务器、同一个 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. 常见坑
比较常见的几个问题:
-
改了 yml 没重启服务
改完配置要重启 Spring Boot 进程。 -
启动脚本里写死了 8080
特别是nohup、systemd、docker-compose、发布脚本里,要一起检查。 -
环境变量覆盖了配置
比如服务器里设置了SERVER_PORT=8080,会把 yml 里的端口覆盖掉。 -
同一个 jar 被启动两次
发布脚本重复执行,旧进程没停,新进程又拉起来,直接冲突。 -
Nginx 转发路径和 context-path 不匹配
比如后端配置了:server: servlet: context-path: /app-aNginx 转发时就要保证路径对得上。
-
WebSocket 项目需要额外 Header
如果项目里有 WebSocket,Nginx 里加上:proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; -
国内地域域名访问 80/443
如果域名解析到中国内地 ECS,通过域名访问 80/443,还要确认备案、解析、安全组这些条件。这个跟端口冲突不是一回事,但线上经常一起遇到。
简单总结:
- 临时解决:
server.port改成不同端口。 - 生产推荐:Spring Boot 各自监听本机端口,Nginx 统一监听 80/443,根据域名或路径转发。
- 安全组只管外部访问,不解决本机端口冲突。
- 排查顺序:
ss/netstat/lsof 查占用→确认启动参数→改端口或改 Nginx→检查安全组和防火墙。
云服务器