同一Docker网络内React容器无法请求Express容器数据的排查求助

核心原因1：Express服务绑定地址错误 #

• 你的Express应用大概率把服务绑定在了127.0.0.1而非0.0.0.0。当绑定127.0.0.1时，服务仅能在容器内部本地访问，同一Docker网络内的其他容器无法连接。
• 你用主机公网IP能访问，是因为Docker端口映射把主机端口转发到了容器的0.0.0.0（Docker端口映射默认监听容器的0.0.0.0），但容器间通信必须让Express监听0.0.0.0。
• 检查Express启动代码：确保是app.listen(8082, '0.0.0.0', callback)，而非app.listen(8082, '127.0.0.1')。

核心原因2：React前端请求地址逻辑错误 #

• 注意：NGINX托管的React应用是静态文件，最终在用户浏览器中运行，请求是从用户浏览器发出的，而非React容器内部。
• 你用Docker内部IP172.19.0.3:8082作为请求地址，浏览器无法访问Docker私有网络的IP，必然超时。
• 正确方案：
  • 方案一：前端请求主机公网IP+映射的端口（比如http://your-public-ip:8082/api），这和你手动测试的逻辑一致。
  • 方案二：在NGINX配置反向代理，将前端的API请求（比如/api开头的路径）转发到Express容器的服务地址（同一Docker网络内可直接用容器名，比如http://express-container-name:8082），前端只需请求相对路径/api即可。

次要排查点：Docker网络配置 #

• 确认两个容器确实在同一网络：执行docker inspect <react-container-id> | grep Networks和docker inspect <express-container-id> | grep Networks，检查所属网络是否一致。
• 如果使用默认bridge网络，容器间通信需用IP；如果是自定义网络，建议用容器名通信（比IP更稳定，IP可能随容器重启变化）。

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