Spring Boot + Nacos + Dubbo 配置最佳实践（优化版）

本文档基于 Spring Boot 2 项目集成 Nacos 作为配置中心与注册中心，并使用 Dubbo 3（Triple 协议 + 应用级服务发现） 的典型配置，提供结构清晰、安全可靠、生产就绪的 YAML 配置模板及关键说明。

📁 一、Nacos 配置中心

nacos:
  config:
    bootstrap:
      enable: true                     # 启用 Nacos Bootstrap 加载（需引入 spring-cloud-starter-bootstrap）
    server-addr: ${NACOS_SERVER_ADDR:ip:port}  # 支持环境变量覆盖
    namespace: ${NACOS_NAMESPACE_ID:your-namespace-id}  # 必须是命名空间 ID（如 UUID），非名称
    group: DEFAULT_GROUP
    data-ids: ${spring.application.name}.yaml  # 主配置 Data ID
    type: yaml
    auto-refresh: true                 # 自动刷新配置
    remote-first: true                 # 优先从远程加载配置
    username: ${NACOS_USERNAME}
    password: ${NACOS_PASSWORD}
    
    # 长轮询与重试参数（可选调优）
    max-retry: 10
    config-retry-time: 20              # 重试间隔（秒）
    config-long-poll-timeout: 46000    # 长轮询超时（毫秒）
    enable-remote-sync-config: true    # 启用远程同步

    # 扩展配置（按需添加多个）
    ext-config[0]:
      data-id: common-config.yaml
      group: DEFAULT_GROUP
      type: yaml
      auto-refresh: true
      max-retry: 10
      config-retry-time: 20
      config-long-poll-timeout: 46000
      enable-remote-sync-config: true

📁 二、Dubbo 3 配置（应用级服务发现 + Triple 协议）

dubbo:
  application:
    name: ${spring.application.name}
    protocol: tri                      # 显式指定首选协议（Triple）
    service-discovery:
      migration: FORCE_APPLICATION     # 强制使用应用级服务发现（Dubbo 3 推荐）
    qos-enable: true                   # 启用 QoS（运维调试）
    qos-port: 22200
    qos-accept-foreign-ip: false       # 安全：禁止外部 IP 访问（生产必须！）

  registry:
    address: nacos://${NACOS_SERVER_ADDR:ip:port}
    username: ${NACOS_USERNAME}
    password: ${NACOS_PASSWORD}
    enable-empty-protection: true      # 防止无 provider 时 consumer 启动失败
    parameters:
      namespace: ${NACOS_NAMESPACE_ID}
      group: DEFAULT_GROUP
      registry-type: service           # 明确使用应用级注册

  config-center:
    address: nacos://${NACOS_SERVER_ADDR:ip:port}
    username: ${NACOS_USERNAME}
    password: ${NACOS_PASSWORD}
    parameters:
      namespace: ${NACOS_NAMESPACE_ID}
      group: DEFAULT_GROUP

  metadata-report:
    address: nacos://${NACOS_SERVER_ADDR:ip:port}
    username: ${NACOS_USERNAME}
    password: ${NACOS_PASSWORD}
    parameters:
      namespace: ${NACOS_NAMESPACE_ID}
      group: DEFAULT_GROUP

  protocol:
    name: tri                          # Triple 协议（兼容 gRPC，支持流式、多语言）
    port: 20770                        # 服务暴露端口（建议固定）

  consumer:
    check: false                       # 启动时不检查 provider 是否可用
    init: false                        # 延迟初始化
    lazy: true                         # 懒加载连接
    timeout: 50000                     # 调用超时（50s）
    retries: 0                         # 禁用重试（防雪崩，幂等接口可酌情开启）
    cluster: failover                  # 容错策略：失败自动切换
    loadbalance: roundrobin            # 负载均衡：轮询