Spring Boot微服务Docker容器间REST通信实战指南-java教程-PHP中文网

Spring Boot微服务Docker容器间REST通信实战指南

本文详解Spring Boot应用在Docker Compose环境下跨容器调用失败的根因与解决方案，重点解决Connection refused问题，涵盖网络配置、服务发现、端口映射逻辑及最佳实践。

本文详解spring boot应用在docker compose环境下跨容器调用失败的根因与解决方案，重点解决`connection refused`问题，涵盖网络配置、服务发现、端口映射逻辑及最佳实践。

在基于Spring Boot的微服务架构中，将服务容器化后实现可靠通信是落地关键一步。许多开发者在本地运行正常的服务，一旦通过Docker Compose部署，便遭遇I/O error on POST request for "http://localhost:8081/processString": Connection refused——这并非代码缺陷，而是对Docker网络模型理解偏差所致。

? 核心误区：`localhost` 在容器内 ≠ 宿主机 `localhost`

在单机开发时，http://localhost:8081 指向本机进程；但当服务运行于独立容器中时，每个容器拥有隔离的网络命名空间，其内部的 localhost 仅指向自身，无法访问同属一个 docker-compose 的其他容器。因此，LogonPage容器尝试连接 localhost:8081 实际是在向自己发请求（而该端口未监听），必然失败。

✅ 正确方案：利用 Docker Compose 内置 DNS 服务发现

Docker Compose 默认为每个服务创建一个可解析的服务名（service name）作为主机名。根据你的 docker-compose.yml：

services:
  appacc:           # ← 该服务名即为容器内可解析的主机名
    build: ...
    ports: ["8081:8080"]  # ← 宿主机8081 → 容器8080
  applog:
    build: ...
    ports: ["8080:8080"]

appacc 容器监听 内部端口 8080（由JVM启动的Spring Boot默认端口）；
applog 容器需调用 appacc 时，应使用 http://appacc:8080/processString；
无需暴露 appacc 到宿主机（即 ports 可选），只要在同一自定义网络（或默认网络）中，容器间即可通过服务名直连。

✅ 修正后的客户端代码（LogonPageApplication）：

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

@SpringBootApplication
@RestController
public class LogonPageApplication {
    // 关键修改：用服务名 'appacc' 替代 'localhost'
    private static final String PROCESS_STRING_URL = "http://appacc:8080/processString";

    @GetMapping("/send")
    public String test() {
        try {
            RestTemplate restTemplate = new RestTemplate();
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            HttpEntity<string> entity = new HttpEntity("{\"testttgfvrdf\"}", headers);

            ResponseEntity<string> response = restTemplate.exchange(
                PROCESS_STRING_URL, 
                HttpMethod.POST, 
                entity, 
                String.class
            );
            return "Main Page\nResponse from /processString: " + response.getBody();
        } catch (Exception e) {
            return "ERROR: " + e.getMessage();
        }
    }
}</string></string>

?️ 配置优化建议

精简网络声明（可选）：
docker-compose.yml 中 networks: my-network 可省略——Docker Compose 默认创建名为 <project-name>_default</project-name> 的桥接网络，所有服务自动加入，且支持服务名解析。
明确容器端口：
在 AcceptMessageApplication 的 application.properties 中显式指定：
```
server.port=8080
```
避免依赖默认值，增强可读性与一致性。
健康检查与重试（生产增强）：
为提升健壮性，可在 RestTemplate 调用中集成 Spring Retry 或改用 WebClient（响应式+内置重试）：
```
@Bean
public WebClient webClient() {
    return WebClient.builder()
            .baseUrl("http://appacc:8080")
            .build();
}
```

⚠️ 注意事项总结

项目	错误做法	正确做法
目标地址	`http://localhost:8081`	`http://appacc:8080`（服务名 + 容器内端口）
端口映射理解	混淆宿主机端口（`8081`）与容器端口（`8080`）	容器间通信只认容器端口，`ports` 仅用于宿主机访问
网络配置	手动定义网络并忽略默认行为	信任默认网络，除非需跨Compose项目通信
调试技巧	仅依赖日志	进入容器执行 `curl -v http://appacc:8080/actuator/health` 验证连通性