Docker容器部署成功后Heroku应用出现502 Gateway错误求助

• 检查容器端口配置
  Heroku采用动态端口分配机制，容器内应用必须监听$PORT环境变量指定的端口，禁止硬编码固定端口。示例代码如下：

  # Python Flask 示例
  import os
  from flask import Flask
  
  app = Flask(__name__)
  
  @app.route('/')
  def hello():
      return "Hello World!", 200
  
  if __name__ == '__main__':
      port = int(os.environ.get("PORT", 5000))
      app.run(host='0.0.0.0', port=port)
  

  Dockerfile无需硬编码EXPOSE端口，但需确保应用启动时正确读取$PORT。

• 查看Heroku实时日志
  执行以下命令获取应用实时运行日志，定位502错误的具体原因（如启动失败、依赖缺失、请求超时等）：

  heroku logs --tail
  

• 本地验证容器运行状态
  模拟Heroku环境变量在本地启动容器，验证应用本身是否能正常响应请求：

  docker run -e PORT=5000 -p 5000:5000 [你的镜像名称]
  

  访问http://localhost:5000，确认是否返回200状态码，排除应用自身问题。

• 检查Dockerfile配置
  确保Dockerfile中已完成依赖安装，且CMD/ENTRYPOINT指令正确启动应用。例如Node.js应用的Dockerfile：

  FROM node:18-alpine
  WORKDIR /app
  COPY package*.json ./
  RUN npm install
  COPY . .
  CMD ["npm", "start"]
  

  注意：npm start对应的启动脚本需读取$PORT环境变量。

• 确认Heroku进程状态
  执行heroku ps查看应用进程状态：

  • 若显示crash：说明应用启动失败，需根据日志排查启动问题
  • 若显示up但仍返回502：需检查应用是否正确监听端口，或是否存在请求超时情况

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