Docker部署Java服务端-客户端架构失败问题排查求助

问题1：能否用服务名称“app_server”替代服务端IP？ #

完全可以。Docker Compose会自动为每个服务创建DNS别名，服务名（比如app_server）就是容器在Compose默认网桥网络里的可解析域名，客户端容器直接用app_server:8899就能连接服务端，不需要硬编码IP。

不需要在容器创建前获取服务端IP——Compose的网络体系已经帮你解决了服务发现的问题，只要客户端和服务端在同一个Compose网络（默认就是同一个），直接用服务名访问即可。你的客户端本来就有每10秒重试发送的逻辑，就算启动时服务端未就绪，后续重试也能成功建立连接。

问题2：容器启动失败、连接拒绝的常见原因及操作误区 #

服务端监听地址错误 #

这是最容易踩的坑：如果服务端代码里ServerSocket绑定的是127.0.0.1（localhost），那么只有服务端容器内部能访问，其他容器根本连不上。必须改成绑定0.0.0.0，这样容器才能接收来自同一网络内其他容器的连接请求。

服务端未就绪前客户端先启动 #

Compose的depends_on仅保证服务端容器先启动，但不保证服务端应用程序已经就绪（比如Java服务还在初始化，ServerSocket还没完成端口监听）。这时候客户端启动后会触发连接拒绝。解决方法是给服务端加上健康检查，让客户端等服务端真正就绪后再启动：

services:
  app_server:
    build: ./server
    healthcheck:
      test: ["CMD", "nc", "-z", "localhost", "8899"]
      interval: 5s
      timeout: 3s
      retries: 5
  app_client1:
    build: ./client1
    depends_on:
      app_server:
        condition: service_healthy
  app_client2:
    build: ./client2
    depends_on:
      app_server:
        condition: service_healthy

Docker Compose配置或代码逻辑错误 #

• 确认服务端的服务名称确实是app_server，客户端代码里的连接地址是app_server:8899，而非宿主机IP或localhost
• 确保所有服务都在同一个网络（默认Compose会创建一个默认网络，所有服务自动加入，除非你手动指定了不同网络）

容器启动镜像或命令问题 #

如果容器直接启动失败，优先排查：

• 镜像构建是否正确：比如Java应用的jar包有没有正确复制到镜像指定路径
• 启动命令是否正确：比如java -jar app.jar中的jar包名称、路径是否匹配
• 查看容器日志：用docker-compose logs app_server或docker-compose logs app_client1获取具体启动报错信息，定位问题

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