在Heroku部署带Nginx代理的Spring Boot应用时遇端口冲突崩溃问题

我之前也踩过这个坑，核心原因很明确：Heroku给每个应用只分配了一个对外暴露的动态端口（通过$PORT环境变量获取），如果Spring Boot和Nginx都试图绑定这个端口，必然会引发冲突。下面是一步步的解决办法：

1. 让Spring Boot使用内部专属端口 #

先修改Spring Boot的配置，让它监听一个固定的内部端口（比如8081），别直接用Heroku的$PORT。两种实现方式任选其一：

• 在application.properties/application.yml里添加配置：

  server.port=8081
  

• 或者在启动命令里直接指定：

  java -jar your-app.jar --server.port=8081
  

2. 配置Nginx反向代理到Spring Boot端口 #

在项目根目录创建nginx.conf.erb文件（这是Heroku Nginx构建包识别的配置模板），内容如下：

worker_processes <%= ENV['NGINX_WORKERS'] || 4 %>;

events {
    use epoll;
    accept_mutex on;
    worker_connections 1024;
}

http {
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

    server {
        listen <%= ENV['PORT'] %>;
        server_name localhost;

        location / {
            proxy_pass http://localhost:8081; # 这里要和Spring Boot的端口完全一致
            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监听Heroku分配的$PORT作为对外入口，把所有请求转发到Spring Boot的内部端口。

3. 用Procfile统一启动流程 #

在项目根目录创建Procfile，指定Nginx和Spring Boot的启动顺序：

web: bin/start-nginx java -jar your-app.jar --server.port=8081

这里的bin/start-nginx是Heroku Nginx构建包自带的启动脚本，会先启动Nginx，再启动你的Spring Boot应用，保证顺序正确。

4. 确认构建包的配置顺序 #

确保你的Heroku应用已经添加了Java和Nginx两个构建包，且顺序正确（先编译Java应用，再处理Nginx配置），如果还没添加，执行以下命令：

heroku buildpacks:add heroku/java
heroku buildpacks:add https://github.com/heroku/heroku-buildpack-nginx

最后验证 #

重新部署后查看日志，应该就不会再出现端口冲突的报错了。如果还有问题，可以重点检查：

• Spring Boot是否确实在8081端口启动
• Nginx配置里的proxy_pass地址是否和Spring Boot端口匹配
• Procfile的启动命令有没有写错

补充一句：Heroku的动态端口只能被一个进程占用，所以必须让Nginx作为对外的唯一入口，Spring Boot跑在内部端口，这才是正确的协作方式。

内容的提问来源于stack exchange，提问作者user3314492