Docker环境下Angular Universal服务端渲染API请求失败排查

核心问题根源 #

你遇到的SSR请求失败，本质是容器内部的域名解析逻辑和Windows主机不一致：

• Windows主机的hosts配置127.0.0.1 api.my-app.local只在主机生效，my_client容器内部解析api.my-app.local时，默认指向容器自身的127.0.0.1，而非Windows主机的Nginx服务。
• 你提到容器内ping api.my-app.local返回127.0.0.1，这就导致SSR请求直接打向my_client容器自身，自然无法拿到正确的API响应。

解决方案1：让容器将域名指向Windows主机（推荐保留Nginx代理链路） #

修改docker-compose.yml中my_client服务的配置，添加extra_hosts字段，强制容器将api.my-app.local解析为Windows主机的局域网IP（不是127.0.0.1）：

my_client:
  container_name: my_client
  build:
    context: ./node_client
  image: my_client
  ports:
    - '8000:8000'
  volumes:
    - ./node_client/app:/var/www/my-app.com
    - /var/www/my-app.com/node_modules
  links:
    - my_api
  # 新增以下配置
  extra_hosts:
    - "api.my-app.local:192.168.xxx.xxx" # 替换为你的Windows主机局域网IP（可通过cmd输入ipconfig查看）
  tty: true
  command: ["pm2-docker", "pm2.config.json"]

验证步骤：

1. 重启容器：docker-compose down && docker-compose up -d
2. 进入my_client容器：docker exec -it my_client bash
3. 执行ping api.my-app.local，此时应该返回你设置的局域网IP，而非127.0.0.1
4. 重新测试SSR请求，此时请求会先到Windows主机的Nginx，再转发至my_api容器，符合你的预期链路。

解决方案2：SSR直接访问Docker内部的API服务（性能更优） #

如果不需要SSR请求经过Nginx代理，可以让my_client容器直接通过Docker内部网络访问my_api服务：

• 在Angular的SSR配置中，判断当前是服务器端渲染时，将API地址改为http://my_api:8001（Docker服务名，容器间可直接通信）
• 客户端渲染仍使用http://api.my-app.local，保持和浏览器请求一致

这种方案跳过了主机的Nginx转发，减少了网络开销，同时避免了域名解析问题。示例代码（Angular SSR配置）：

// 在server.ts或API拦截器中判断环境
const isServer = typeof window === 'undefined';
const apiBaseUrl = isServer ? 'http://my_api:8001' : 'http://api.my-app.local';

补充说明 #

你之前在my_api服务中配置的networks.default.aliases: api.my-app.local，是Docker内部网络的别名，仅在容器间生效。如果my_client容器用这个别名请求，会直接访问my_api容器，不会经过Windows主机的Nginx，这也是为什么你替换为api.my-app.local时请求指向自身的原因（因为容器内部解析这个别名时，实际是找Docker网络内的服务，但你的请求逻辑可能还是走了127.0.0.1的解析）。

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