Heroku部署Flask应用需设置哪个端口？端口占用报错如何解决

原有配置的问题 #

你之前尝试的三种配置都不符合Heroku的部署规则，具体问题如下：

• app.run(port=int(os.environ.get('PORT')))：没有配置服务绑定的host为0.0.0.0，Heroku的反向代理无法访问到绑定在回环地址上的服务；同时没有给PORT变量设置兜底值，本地调试时容易出现取值为空的报错
• app.run(port=5000)/app.run(port=8000)：Heroku每次启动dyno时都会动态分配服务端口，硬编码固定端口必然和平台分配的端口冲突，直接触发端口占用报错
• app.run()：默认绑定127.0.0.1回环地址、默认监听5000端口，既不符合动态端口规则，也无法接收平台转发的请求

你日志里提示被占用的随机端口（比如12755），本质就是Heroku给当前dyno分配的服务端口，出现占用报错不是有其他无关程序抢端口，绝大多数情况是你的应用重复启动了多个服务实例，自己占了目标端口。

正确端口配置 #

首先保证代码里的服务启动逻辑符合平台要求，参考如下配置：

import os
from flask import Flask

app = Flask(__name__)

# 此处编写你的业务路由、插件初始化等逻辑

if __name__ == '__main__':
    # 优先读取Heroku动态注入的PORT环境变量，本地调试时默认用5000端口
    server_port = int(os.environ.get("PORT", 5000))
    # *必须绑定0.0.0.0地址*，允许所有网卡的请求接入，这是新手最容易遗漏的配置
    app.run(host="0.0.0.0", port=server_port)

注意必须保留if __name__ == '__main__':的判断，避免用生产WSGI服务器启动应用时，自动触发Flask内置开发服务器启动，导致多实例抢端口。

配套配置与报错排查 #

• 确认项目根目录下Procfile配置正确，Heroku通过这个文件识别web进程启动命令，生产环境推荐用gunicorn作为WSGI服务器，配置参考：

  web: gunicorn --bind 0.0.0.0:$PORT 你的主程序文件名:app
  

  注意如果用上面的gunicorn命令启动，gunicorn会自动读取PORT环境变量绑定端口，不需要在gunicorn参数里硬编码固定端口。
• 全局检查代码，确认没有在主入口之外的地方重复调用app.run()，避免多实例启动。
• 不要尝试在代码里手动kill所谓“占用端口的其他程序”，Heroku的dyno环境是隔离的，除了你的应用本身不会有其他无关服务占用分配给你的端口。
• 如果是本地开发时遇到端口占用，直接杀掉对应占用端口的旧进程即可，和Heroku部署场景的报错逻辑不同。

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