Spring Boot应用Docker部署后无法连接ScyllaDB求助

1. 连接失败的直接原因：容器内网络寻址错误 #

你的Java代码里用了127.0.0.1:9042/9043/9044，这在宿主机运行Spring Boot时没问题——因为宿主机的127.0.0.1指向自身，而你已经把Scylla容器的9042端口映射到宿主机的9042/9043/9044。但当Spring Boot也放进Docker容器后：

• 容器内的127.0.0.1是容器自身，不是宿主机
• 同一docker-compose网络里的服务，应该用服务名+容器内部端口通信，Scylla容器内部的CQL端口始终是9042，宿主机映射的9043/9044只是给外部访问用的

修改后的Java连接代码 #

@Bean
public Cluster cluster() {
    Cluster cluster = Cluster.builder().addContactPointsWithPorts(
                    new InetSocketAddress("scylla-node1", 9042),
                    new InetSocketAddress("scylla-node2", 9042),
                    new InetSocketAddress("scylla-node3", 9042))
            .build();
    return cluster;
}

2. docker-compose depends_on的局限性 #

depends_on只会等待Scylla容器启动，不会等待Scylla服务完全就绪（比如节点完成初始化、加入集群）。即使你手动等很久再启动应用，只要代码里的地址错了还是连不上，但地址修正后，还需要解决启动时机的问题。

解决等待Scylla就绪的两种方案 #

方案一：给Scylla添加健康检查，让应用等待健康状态

修改Scylla服务的docker-compose配置，添加健康检查（用nodetool status判断节点是否就绪）：

services:
  scylla-node1:
    container_name: scylla-node1
    image: scylladb/scylla:4.5.0
    restart: always
    command: --seeds=scylla-node1,scylla-node2 --smp 1 --memory 750M --overprovisioned 1 --api-address 0.0.0.0
    ports:
      - 9042:9042
    volumes:
      - "./scylla/scylla.yaml:/etc/scylla/scylla.yaml"
      - "./scylla/cassandra-rackdc.properties.dc1:/etc/scylla/cassandra-rackdc.properties"
    networks:
      - scylla-network
    healthcheck:
      test: ["CMD", "nodetool", "status"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 20s # 给节点初始化留时间

  # scylla-node2、scylla-node3 同样添加上述healthcheck配置

然后修改my-app的depends_on，等待Scylla节点进入健康状态：

my-app:
    container_name: my-app
    build:
      context: .
      dockerfile: Dockerfile
    image: my-app
    ports:
      - 8082:8082
    depends_on:
      scylla-node1:
        condition: service_healthy
      scylla-node2:
        condition: service_healthy
      scylla-node3:
        condition: service_healthy
    networks:
      - scylla-network

方案二：在Spring Boot中添加连接重试机制

即使应用先启动，让DataStax驱动自动重试连接，避免启动失败。可以配置驱动的重试策略，或者用Spring的重试注解：

1. 配置DataStax驱动的重试（在Cluster.builder中添加）：

Cluster cluster = Cluster.builder()
        .addContactPointsWithPorts(/* ... */)
        .withRetryPolicy(DowngradingConsistencyRetryPolicy.INSTANCE)
        .withReconnectionPolicy(new ConstantReconnectionPolicy(1000)) // 每秒重试一次
        .build();

2. 或者给Session Bean添加重试：

@Bean
@Retryable(value = {NoHostAvailableException.class}, maxAttempts = 10, backoff = @Backoff(delay = 2000))
public Session session(Cluster cluster, @Value("${scylla.keyspace}") String keyspace) throws IOException {
    final Session session = cluster.connect();
    setupKeyspace(session, keyspace);
    return session;
}

@Recover
public Session recoverSession(NoHostAvailableException e, Cluster cluster, @Value("${scylla.keyspace}") String keyspace) throws IOException {
    // 最后重试失败后的处理，比如抛出异常或日志告警
    throw new RuntimeException("Failed to connect to Scylla after retries", e);
}

需要添加Spring Retry依赖到pom.xml或build.gradle。

3. 验证步骤 #

1. 修正Java代码中的连接地址为Scylla服务名+9042端口
2. 给Scylla节点添加健康检查（或配置应用重试）
3. 重新构建应用镜像，启动docker-compose：docker-compose up --build

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