Docker容器微服务架构下KrakenD API网关转发请求被拒绝如何解决

1. 验证容器间网络连通性 #

首先进入api-gateway容器，直接测试是否能访问auth-service的4000端口，确认是网络问题还是网关配置问题：

# 查看网关容器ID/名称
docker ps
# 进入容器执行连通性测试（krakend镜像自带wget）
docker exec -it <网关容器ID> wget -O - http://auth-service:4000/auth/check

如果请求正常返回，说明是krakend配置或启动顺序问题；如果请求报错，继续往下排查。

2. 修复Docker Compose环境变量语法错误 #

你当前的docker-compose.yml中所有服务的DB_URL配置存在语法错误，等号两侧不能有空格，否则会导致环境变量名带空格，服务读取不到正确配置：

# 错误写法
- DB_URL = mongodb://db/MagicMeal
# 正确写法
- DB_URL=mongodb://db/MagicMeal

修改所有服务的该配置项后，重新构建启动容器。

3. 检查Node.js服务监听地址 #

确认auth-service启动时监听的是0.0.0.0而非127.0.0.1，如果监听127.0.0.1，仅能接收容器内部请求，其他容器访问会被拒绝：

// 错误写法，仅容器内部可访问
app.listen(4000, '127.0.0.1', () => {})
// 正确写法，允许跨容器访问
app.listen(4000, '0.0.0.0', () => {})

4. 配置服务启动顺序与健康检查 #

Krakend启动时如果auth-service还未完成初始化，会直接报连接拒绝错误，你可以在docker-compose中添加健康检查，确保auth-service启动完成后再启动网关：

services:
  api-gateway:
    build: "./gateway"
    ports:
      - 3001:3001
    depends_on:
      auth-service:
        condition: service_healthy
  auth-service:
    build: "./authService"
    ports:
      - 4000:4000
    environment:
      - DB_URL=mongodb://db/MagicMeal
    volumes:
      - ./authService:/app
    healthcheck:
      test: ["CMD", "wget", "-q", "--spider", "http://localhost:4000/auth/check"]
      interval: 5s
      timeout: 2s
      retries: 5

5. 快速验证方案 #

如果要快速排除启动顺序问题，可以先单独启动auth-service，等待10秒后再启动网关：

docker compose up -d auth-service
sleep 10
docker compose up -d api-gateway

之后再测试网关转发请求是否正常即可。

内容的提问来源于stack exchange，提问作者Noor Ul Ain Butt