Docker-Compose部署Flask应用正常，PyCharm作为解释器时端口无法访问

问题背景 #

Windows 10环境下，用Docker搭建的Flask应用，直接运行docker-compose up时可以通过localhost:5000正常访问；但将Docker-Compose配置为PyCharm的Python解释器后，外部浏览器访问localhost:5000提示ERR_CONNECTION_REFUSED，不过在PyCharm的调试终端里用curl能正常访问容器内的Flask端点，说明应用本身运行正常。

可能的解决方案 #

1. 确认PyCharm解释器配置的端口映射 #

打开PyCharm的设置：

• 路径：File → Settings → Project: [你的项目名] → Python Interpreter
• 点击齿轮图标选择Add，切换到Docker Compose标签页
• 确认选中的Service是archives_app，然后检查Port bindings区域是否添加了5000:5000的映射，若没有则手动添加并保存配置。

2. 验证Flask启动命令未被PyCharm修改 #

PyCharm可能会自动覆盖启动参数，需确认Debug/Run配置中的命令：

• 打开Run → Edit Configurations
• 找到对应的Flask或Docker Compose配置，查看Command字段是否为：

  flask run --host=0.0.0.0 --port=5000 --reload
  

  如果被修改为绑定127.0.0.1，手动改回--host=0.0.0.0。

3. 检查Windows防火墙与WSL2端口转发 #

• 临时测试防火墙：关闭Windows Defender防火墙，尝试再次访问localhost:5000，若能访问则需手动添加允许Docker Desktop或5000端口入站的规则。
• WSL2端口转发修复：如果使用WSL2后端的Docker，可能存在localhost转发bug：
  1. 在WSL终端中执行ip addr获取eth0的inet地址（比如192.168.80.3）
  2. 在Windows PowerShell中以管理员身份执行：

     netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=5000 connectaddress=192.168.80.3 connectport=5000
     

  3. 执行netsh interface portproxy show all确认转发规则已添加。

4. 检查PyCharm Debug配置的端口转发 #

• 打开Run → Edit Configurations，选中对应的Debug配置
• 切换到Docker标签页，查看Port forwarding是否包含5000:5000，若缺失则手动添加。

5. 尝试直接用容器IP访问 #

从提供的容器网络设置中，容器IP为192.168.80.3，直接在浏览器访问http://192.168.80.3:5000：

• 若能访问，说明是localhost的转发问题，可修改Windows的hosts文件（路径C:\Windows\System32\drivers\etc\hosts），添加一行：

  192.168.80.3 localhost
  

  保存后再次尝试用localhost访问。

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