Docker容器内Flask API无法响应Postman请求问题求助

1. 优先检查容器端口映射配置 #

这是最高发的问题，ECONNREFUSED 127.0.0.1:3000错误绝大多数都是该问题导致：

• Docker默认不会将容器内部端口暴露给宿主机网络，启动容器时必须显式添加端口映射参数
• 正确启动命令示例：

docker run -p 3000:3000 你的Flask镜像名称

• 其中-p 3000:3000表示将宿主机的3000端口映射到容器内部的3000端口，映射规则为宿主机端口:容器内服务端口
• 执行docker ps查看PORTS列，确认是否存在类似0.0.0.0:3000->3000/tcp的映射记录

2. 确认Flask监听配置 #

• 从给出的日志可见Running on all addresses，说明Flask已经配置监听0.0.0.0，该配置符合要求
• 如果后续修改代码，需要确保启动代码包含host配置，示例：

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=3000)

如果未配置host='0.0.0.0'，Flask默认仅监听容器内部的127.0.0.1，外部网络无法访问

3. 检查防火墙与安全组规则 #

访问公网IP返回ETIMEDOUT错误多数是该问题导致：

• 如果是云服务器部署，需要确认云服务器安全组的入方向规则已经放行3000端口
• 检查宿主机本地防火墙规则：
  • 若宿主机为Ubuntu/Debian系统，执行ufw status确认3000端口是否放行
  • 若宿主机为CentOS/RHEL系统，执行firewall-cmd --list-all确认3000端口是否放行

4. 验证容器服务运行状态 #

• 执行docker ps确认容器处于Up运行状态，无异常退出
• 执行docker logs 容器ID/容器名查看服务日志，确认Flask服务没有启动报错
• 可进入容器内部验证服务可用性：

# 进入容器
docker exec -it 容器ID/容器名 /bin/bash
# 容器内部执行请求验证服务是否正常
curl -X POST http://127.0.0.1:3000/你的接口路径

如果容器内部请求正常，说明问题出在容器到宿主机的网络链路配置上；如果容器内部也请求不到，说明Flask服务本身存在逻辑问题

5. 特殊场景排查 #

• 如果宿主机有其他服务占用了3000端口，可修改端口映射参数，比如-p 3001:3000，之后访问宿主机的3001端口即可
• 如果是在WSL2环境下运行Docker，需要确认WSL2的端口转发规则是否正常，也可以直接使用WSL2的内部IP访问服务

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