如何用Spring Data Couchbase结合YAML配置连接Couchbase及多环境适配？

Couchbase 连接字符串说明 #

Couchbase 连接字符串用于指定目标集群节点，格式分以下几种：

• 单节点（开发常用）：couchbase://localhost
• 多节点集群：couchbase://node1,node2,node3（逗号分隔多个节点地址）
• SSL加密连接：couchbases://node1,node2（生产环境推荐，需配合SSL证书配置）

在 Spring Boot 的 application.yaml 中，对应配置项为 spring.data.couchbase.connection-string。

多环境（Dev/Prod）配置方案 #

开发环境（Dev） #

以便捷调试、快速验证为核心，配置要点：

• 连接字符串：使用本地单节点 couchbase://localhost
• 认证信息：采用本地测试账号（如默认管理员账号），密码设置简单易记
• 桶配置：使用专门的开发测试桶
• 日志：开启Couchbase相关日志调试，方便排查连接或查询问题
• 示例配置：

spring:
  profiles: dev
  data:
    couchbase:
      connection-string: couchbase://localhost
      username: Administrator
      password: dev123456
      bucket-name: dev-test-bucket
logging:
  level:
    org.springframework.data.couchbase: DEBUG

生产环境（Prod） #

以稳定性、安全性、性能为核心，配置要点：

• 连接字符串：配置完整的集群节点列表（如 couchbases://prod-node-01,prod-node-02,prod-node-03），启用SSL加密
• 认证信息：使用权限受限的专用生产账号，密码通过环境变量注入（避免硬编码）
• SSL配置：指定SSL证书路径及密码，确保数据传输加密
• 超时与重试：设置合理的连接、查询超时时间，启用重试机制提升集群容错性
• 日志：关闭调试日志，仅保留INFO及以上级别，减少性能开销
• 示例配置：

spring:
  profiles: prod
  data:
    couchbase:
      connection-string: couchbases://prod-node-01,prod-node-02,prod-node-03
      username: prod-couchbase-service
      password: ${COUCHBASE_PROD_PASSWORD}
      bucket-name: prod-business-bucket
      env:
        ssl:
          enabled: true
          key-store: classpath:couchbase-prod-cert.p12
          key-store-password: ${COUCHBASE_SSL_PASSWORD}
        timeout:
          connect: 10s
          query: 30s
        retry:
          enabled: true
          max-attempts: 3
logging:
  level:
    org.springframework.data.couchbase: INFO

环境激活方式 #

通过以下方式指定运行环境：

• 启动参数：java -jar your-app.jar --spring.profiles.active=dev
• 环境变量：设置 SPRING_PROFILES_ACTIVE=prod（适合容器化部署）

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