Spring Boot集成Couchbase Docker部署连接失败问题求助

1. 解决DNS SRV查询失败问题 #

Couchbase Java SDK默认会尝试DNS SRV查询发现集群节点，但Docker Compose内部网络不支持该机制，直接禁用即可：

• 修改Spring Boot的application.yml连接字符串，添加enableDnsSrv=false参数：

spring:
  couchbase:
    connection-string: couchbase://${COUCHBASE_HOST}?enableDnsSrv=false

• 确保${COUCHBASE_HOST}的值是docker-compose.yml中Couchbase服务的名称（比如couchbase-server），而非localhost或宿主机IP——容器间通过服务名访问是Docker Compose内部网络的标准方式。

2. 解决认证失败与连接超时问题 #

（1）让Spring Boot等待Couchbase完全启动 #

Couchbase启动需完成集群初始化，耗时远长于Spring Boot，直接启动会导致连接时认证失败或超时，可通过两种方式处理：

• 在docker-compose.yml中给Spring Boot服务添加健康检查依赖，等待Couchbase就绪：

services:
  couchbase-server:
    image: couchbase:enterprise-7.2.0
    ports:
      - "8091-8096:8091-8096"
      - "11210-11211:11210-11211"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8091/pools/default"]
      interval: 10s
      timeout: 5s
      retries: 10
  spring-app:
    build: .
    env_file: .env
    depends_on:
      couchbase-server:
        condition: service_healthy

• 或在Spring Boot中配置连接超时与重试策略：

spring:
  couchbase:
    env:
      timeout:
        connect: 30s
      retry:
        kv:
          max-attempts: 5
          delay: 2s

（2）验证Couchbase初始化配置 #

本地运行正常说明bucket、用户名密码正确，但Docker环境中需确保Couchbase自动初始化这些资源：

• 编写init-couchbase.sh初始化脚本：

#!/bin/bash
set -e

# 等待Couchbase服务就绪
until curl -s http://localhost:8091/pools/default > /dev/null; do
  sleep 5
done

# 初始化集群内存配额
curl -X POST http://localhost:8091/pools/default -d memoryQuota=512 -d indexMemoryQuota=256

# 创建管理员用户
curl -X POST http://localhost:8091/settings/web -d username=${COUCHBASE_USER} -d password=${COUCHBASE_PASSWORD}

# 创建目标bucket
curl -u ${COUCHBASE_USER}:${COUCHBASE_PASSWORD} -X POST http://localhost:8091/pools/default/buckets -d name=${COUCHBASE_BUCKET} -d bucketType=couchbase -d ramQuotaMB=256

• 在docker-compose.yml的Couchbase服务中挂载并执行脚本：

couchbase-server:
  # 其他配置...
  volumes:
    - ./init-couchbase.sh:/opt/couchbase/init.sh
  command: /opt/couchbase/init.sh && /entrypoint.sh couchbase-server

• 确保.env文件中的COUCHBASE_USER、COUCHBASE_PASSWORD、COUCHBASE_BUCKET与初始化脚本内容完全一致，无大小写或拼写错误。

（3）检查Docker网络配置 #

• 确保Spring Boot与Couchbase服务处于同一Docker网络（默认docker-compose会创建共享网络，无需额外配置）。
• 容器内不要用宿主机端口访问Couchbase，直接使用服务名即可，Couchbase SDK会自动处理内部端口映射。

3. 验证修复后的启动流程 #

1. 清理旧容器与数据卷：docker-compose down -v
2. 重新启动容器：docker-compose up -d
3. 查看Spring Boot日志：docker logs <spring-app-container-name>，确认连接状态。

若仍有问题，可通过宿主机访问http://localhost:8091进入Couchbase控制台，手动检查bucket是否存在、用户是否拥有该bucket的访问权限。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu