Flutter应用连接Docker容器无响应问题求助

1. 确认Docker端口映射是否正确 #

• 启动容器时必须将容器内服务监听的6060端口映射到宿主机的8080端口，命令示例：

  docker run -p 8080:6060 <你的镜像名称/ID>
  

• 执行 docker ps 查看容器的PORTS列，确认存在0.0.0.0:8080->6060/tcp的映射记录。如果没有，停止容器后重新启动并添加端口映射参数。

2. 验证容器内服务状态 #

• 进入容器内部：

  docker exec -it <容器ID/名称> bash
  

• 在容器内执行 curl localhost:6060，确认服务能正常响应；或者用 netstat -tulpn | grep 6060 检查服务是否在6060端口监听。如果服务未启动或监听端口错误，外部请求必然无响应。

3. 排查宿主机网络与防火墙 #

• 在宿主机上执行 curl localhost:8080，如果同样无响应，检查宿主机防火墙规则：
  • Linux系统：执行 ufw status 查看是否拦截了8080端口，必要时添加允许规则：ufw allow 8080
  • Windows/macOS：在系统防火墙设置中确认8080端口已被允许通过
• 不要直接使用容器内部IP（172.17.0.2）访问：Docker默认bridge网络的内部IP仅宿主机能直接访问，但Chrome运行在沙箱环境中，可能无法访问该私有IP段，且这种方式不符合生产环境规范。

4. 处理Flutter Web的跨域限制 #

• 打开Chrome开发者工具（F12）切换到Network标签，检查请求是否存在CORS（跨域资源共享）错误。Flutter Web默认运行在http://localhost:5000，如果后端服务未配置允许该Origin的CORS头，浏览器会拦截请求。
• 临时测试方案：关闭Chrome的同源策略（仅用于调试）：

  chrome --disable-web-security --user-data-dir=/tmp/chrome-dev-session
  

• 生产环境方案：在后端服务中添加CORS响应头，例如：

  Access-Control-Allow-Origin: http://localhost:5000
  Access-Control-Allow-Methods: GET, POST, PUT, DELETE
  Access-Control-Allow-Headers: Content-Type
  

5. 检查Docker网络模式 #

• 如果使用自定义网络，确认宿主机与容器处于同一网络环境，且端口映射规则生效。
• 若使用host网络模式（docker run --net=host <镜像名>），容器会直接使用宿主机网络，此时可直接访问localhost:6060，但该模式在Windows/macOS的Docker Desktop下可能存在兼容性问题，需谨慎使用。

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