Docker Compose启动SpringBoot应用无法连接Zeebe的问题

核心问题原因 #

1. 服务名解析失败（zeebe:26500报错）：SpringBoot容器与Zeebe容器不在同一个Docker网络中，导致无法通过服务名zeebe解析到目标容器。Docker Compose默认会为同一配置下的服务创建专属网络，只有同网络内的容器才能互相通过服务名访问。
2. 本地回环无法访问（127.0.0.1:26500报错）：容器内的127.0.0.1指向容器自身的回环地址，而非宿主机，因此无法访问宿主机映射的Zeebe端口。而IDE运行的SpringBoot处于宿主机环境，所以能正常访问127.0.0.1:26500。

具体解决方案 #

方案1：将SpringBoot应用纳入同一Docker Compose配置 #

把SpringBoot服务添加到现有docker-compose.yml中，确保两者处于同一网络：

version: '3.8'

services:
  zeebe:
    image: camunda/zeebe:8.5.0
    container_name: zeebe
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9600/ready"]
      interval: 30s
      timeout: 10s
      retries: 5
    ports:
      - "26500:26500"
      - "9600:9600"
      - "8088:8080"

  spring-boot-app:
    build: ./your-spring-boot-project  # 替换为你的SpringBoot项目构建路径
    container_name: spring-boot-app
    depends_on:
      zeebe:
        condition: service_healthy  # 等待Zeebe健康后再启动
    environment:
      - ZEEBE_CLIENT_BROKER_GATEWAY_ADDRESS=zeebe:26500
      - ZEEBE_CLIENT_SECURITY_PLAINTEXT=true
    ports:
      - "8080:8080"  # 替换为你的应用端口

此时SpringBoot应用的application.yaml可保持原配置，或用环境变量覆盖。

方案2：手动将SpringBoot容器加入Zeebe所在网络 #

如果SpringBoot是单独启动的容器，先查看Zeebe所在的Docker网络：

docker network ls
# 找到Zeebe对应的网络（通常是docker-compose项目名_default）
docker network inspect <network-name>

启动SpringBoot容器时指定该网络：

docker run -d --name spring-boot-app --network <network-name> \
  -e ZEEBE_CLIENT_BROKER_GATEWAY_ADDRESS=zeebe:26500 \
  -e ZEEBE_CLIENT_SECURITY_PLAINTEXT=true \
  -p 8080:8080 \
  your-spring-boot-image:tag

方案3：添加连接重试机制 #

即使Zeebe显示健康，网关可能仍未完全就绪，可在SpringBoot中配置Zeebe客户端重试：

zeebe:
  client:
    broker:
      gateway-address: zeebe:26500
      retry:
        max-attempts: 10
        backoff-factor: 2
        initial-delay: 500
    security:
      plaintext: true

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