Docker部署Flask应用后访问localhost:5000连接重置问题排查

问题原因排查及解决方法 #

原因1：容器内Flask服务未真正监听0.0.0.0 #

虽然wsgi.py里指定了host='0.0.0.0'，但可能存在以下情况导致服务实际监听容器的127.0.0.1：

• 导入的app模块（如app.py）中，在非__name__ == '__main__'的分支里调用了app.run()，且未指定host='0.0.0.0'，导致服务提前以默认的127.0.0.1启动，阻塞了后续wsgi.py的执行。
• wsgi.py中的application.run()未被执行（比如脚本执行流程被提前终止）。

解决方法：

1. 检查app.py（或其他被导入的Flask应用文件），确保只有在__name__ == '__main__'分支下才调用app.run()，避免导入时自动启动服务：

   # app.py 示例
   from flask import Flask
   app = Flask(__name__)
   
   @app.route('/')
   def index():
       return "Hello Flask!"
   
   # 仅直接运行app.py时启动服务
   if __name__ == '__main__':
       app.run(host='0.0.0.0', debug=True)
   

2. 确认wsgi.py执行逻辑：确保from app import app不会触发服务启动，且__name__ == '__main__'分支能正常执行application.run(host='0.0.0.0')。

原因2：容器内服务端口监听不一致 #

可能存在端口配置不匹配的情况：

• Flask服务被配置为监听其他端口（代码中指定了port=其他值），但docker-compose的端口映射仍指向5000。
• 容器内其他进程占用了5000端口，导致Flask服务无法正常监听。

解决方法：

1. 统一端口配置：检查wsgi.py和app.py中的端口设置，确保与docker-compose的端口映射一致。例如若Flask监听8000端口，修改docker-compose.yml：

   ports:
     - 127.0.0.1:5000:8000
   

2. 检查容器内端口占用：执行命令docker exec -it <容器名称或ID> netstat -tulpn，查看5000端口是否被正确监听。若被占用，停止对应进程或更换Flask监听端口。

原因3：Docker镜像构建存在缺陷 #

镜像构建时可能遗漏依赖文件，导致Flask服务启动后异常退出（终端显示服务运行，但实际已崩溃）。

解决方法：

1. 完善Dockerfile，确保安装所有依赖：

   FROM python:3.9-slim
   
   WORKDIR /app
   
   COPY requirements.txt .
   RUN pip install --no-cache-dir -r requirements.txt
   
   COPY . .
   

2. 查看容器日志排查错误：执行docker-compose logs -f，查看服务启动后的详细日志，确认是否存在依赖缺失或代码错误。

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