Docker-Compose部署Flask+Gunicorn+Nginx后POST请求报500错误

1. Flask应用代码本身存在错误 #

• 检查/api1和/api2的视图函数是否正确声明了methods=['POST']，比如是否漏写导致默认仅支持GET请求；更可能的情况是函数内部存在未捕获异常：
  • 直接调用request.json['key']但请求未传入对应字段
  • 数据库连接失败、文件读写错误等未处理的异常
• 执行docker logs <你的flask容器名>查看Flask容器日志，500错误会输出详细堆栈跟踪，直接定位代码问题。

2. Docker环境依赖或配置错误 #

• 检查Dockerfile是否正确安装了所有Python依赖：是否COPY了requirements.txt并执行pip install -r requirements.txt
• 确认Flask启动命令是否正确：比如是否使用flask run --host=0.0.0.0（确保容器内服务可被外部访问），是否设置了FLASK_APP=flask_app.py等必要环境变量

3. Nginx反向代理配置问题（针对80端口请求） #

虽然直接访问5000端口也返回500，但Nginx的500日志通常是后端Flask返回错误导致的，仍需检查：

• nginx.conf中反向代理地址是否正确，比如是否指向Flask容器的服务地址（如proxy_pass http://flask-service:5000;，flask-service需与docker-compose.yml中的服务名一致）
• 是否配置了必要的请求头传递，比如添加proxy_set_header Host $host;，避免Flask因请求头缺失报错
• 是否设置了合适的请求体大小限制，比如client_max_body_size 10M;，防止大POST请求触发错误

4. Docker Compose网络配置问题 #

• 确认Flask服务与Nginx服务是否在同一网络中，默认docker-compose会创建默认网络，若手动指定网络需确保两者都加入
• 检查Flask服务的端口映射是否正确，比如ports: - "5000:5000"，确保容器内5000端口映射到主机5000端口

1. 查看Flask容器日志，这是定位500错误最直接的方式
2. 进入Flask容器，执行curl -X POST http://localhost:5000/api1，直接测试容器内服务的响应情况
3. 检查Flask代码中POST接口的参数处理、异常捕获逻辑

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