Docker Compose中FeignClient仅Service1可连接的问题排查求助

我基于Spring Cloud构建了两个微服务：

• ApiGateway（本地运行地址：http://localhost:6800）
• ExampleService（本地运行地址：http://localhost:6801）

ExampleService内包含3个控制器：

• Service1Controller：路径为api/service1
• Service2Controller：路径为api/service2
• Service3Controller：路径为api/service3

ApiGateway通过FeignClient调用ExampleService，核心代码如下：

Service1相关实现 #

@FeignClient(value = "service"//ExampleService应用名称
                    , path = "/api/service1"//ExampleService的前置路径
                    , url = "${service.url}" //本地配置为http://localhost:6801
                    , configuration = FeignConfiguration.class
)
public interface Service1Request {
....
}

------------------
@RestController
@RequestMapping("gateway/service1") //网关前置路径
public class Service1Controller {
    @Autowired
    private Service1Request service1Request;

    .....
}

Service2相关实现 #

@FeignClient(contextId="service2", value = "service"//ExampleService应用名称
                    , path = "/api/service2"//ExampleService的前置路径
                    , url = "${service.url}" //本地配置为http://localhost:6801
                    , configuration = FeignConfiguration.class
)
public interface Service2Request {
....
}

------------------
@RestController
@RequestMapping("gateway/service2") //网关前置路径
public class Service2Controller {
    @Autowired
    private Service2Request service2Request;

    .....
}

Service3相关实现 #

@FeignClient(contextId="service3", value = "service"//ExampleService应用名称
                    , path = "/api/service3"//ExampleService的前置路径
                    , url = "${service.url}" //本地配置为http://localhost:6801
                    , configuration = FeignConfiguration.class
)
public interface Service3Request {
....
}

------------------
@RestController
@RequestMapping("gateway/service3") //网关前置路径
public class Service3Controller {
    @Autowired
    private Service3Request service3Request;

    .....
}

本地运行时所有服务均正常，但通过Docker Compose部署后，ApiGateway仅能连接Service1，Service2和Service3无法建立连接，请求解决办法。

1. 修正容器环境下的服务访问地址 #

Docker Compose部署时，容器之间不能用localhost访问，需要通过服务名通信。你当前的${service.url}配置为http://localhost:6801，在容器环境中会指向ApiGateway自身，而非ExampleService容器。

• 修改配置文件（如application.yml）：

  service:
    url: http://exampleservice:6801
  

  注意：这里的exampleservice是Docker Compose中ExampleService的服务名，需与Compose文件内的服务名称一致（Docker服务名默认小写）。

2. 统一FeignClient的contextId配置 #

Service1的FeignClient未指定contextId，而Service2、Service3指定了。当多个FeignClient的value相同时，必须保证contextId唯一，否则会导致Bean注册冲突，引发注入失败。

• 给Service1的FeignClient补充唯一的contextId：

  @FeignClient(contextId="service1", value = "service"
                      , path = "/api/service1"
                      , url = "${service.url}"
                      , configuration = FeignConfiguration.class
  )
  public interface Service1Request {
  ....
  }
  

3. 检查容器网络连通性 #

确保两个服务处于同一Docker网络，否则无法互相访问：

1. 查看Docker Compose文件，确认两个服务都加入了同一个自定义网络：

   version: '3.8'
   services:
     apigateway:
       build: ./apigateway
       ports:
         - "6800:6800"
       networks:
         - microservice-network
     exampleservice:
       build: ./exampleservice
       ports:
         - "6801:6801"
       networks:
         - microservice-network
   
   networks:
     microservice-network:
       driver: bridge
   

2. 进入ApiGateway容器，手动测试网络连通性：

   # 进入ApiGateway容器
   docker exec -it <api-gateway-container-id> /bin/bash
   # ping ExampleService服务名，验证网络可达
   ping exampleservice
   # 调用Service2接口，验证服务可用
   curl http://exampleservice:6801/api/service2/xxx
   

4. 校验接口路径拼接正确性 #

本地运行正常不代表容器内路径拼接无问题，需检查ExampleService的控制器注解：
确保控制器的@RequestMapping开头带有斜杠，避免FeignClient的path与控制器路径拼接错误：

@RestController
@RequestMapping("/api/service2") // 必须带开头斜杠
public class Service2Controller {
    // ...
}

5. 查看容器日志定位错误 #

通过日志排查具体问题：

# 查看ApiGateway日志，关注Feign调用报错信息
docker logs <api-gateway-container-id>
# 查看ExampleService日志，关注请求接收情况
docker logs <exampleservice-container-id>

日志中通常会包含连接超时、路径不存在、Bean注入失败等具体提示，帮助快速定位问题。

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