BUG分析微服务无法读取Nacos中的共享配置

JAY.LIN 收录于 Bug

2025-03-12 约 899 字预计阅读 2 分钟

https://bing.ee123.net/img/rand?artid=146195277

【BUG分析】微服务无法读取Nacos中的共享配置

项目场景

基于Spring Cloud微服务的商城系统。

使用Nacos进行统一配置管理，在 bootstrap.xml 中读取配置参数。

问题描述

购物车微服务可以读取Nacos中的共享mybatis配置，商品管理微服务却读不到，启动报错提示无法配置数据库源：

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2025-03-12 08:37:45.930 ERROR 11556 --- [           main] o.s.b.d.LoggingFailureAnalysisReporter   : 

***************************
APPLICATION FAILED TO START
***************************

Description:

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

Reason: Failed to determine a suitable driver class


Action:

Consider the following:
	If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.
	If you have database settings to be loaded from a particular profile you may need to activate it (the profiles local are currently active).


Process finished with exit code 1

可能的原因分析

检查 bootstrap.yaml 中的Nacos服务器地址和共享配置文件名字：

spring:
  application:
    name: item-service  # 微服务名称
  profiles:
    active: dev
  cloud:
    nacos:
      server-addr: 192.168.119.128:8848
      config:
        file-extension: yaml  # 文件后缀名
        shared-configs:   # 共享配置
          - data-id: shared-jdbc.yaml # 共享mybatis配置
          - data-id: shared-log.yaml  # 共享日志配置
          - data-id: shared-swagger.yaml  # 共享日志配置
          - data-id: shared-seata.yaml

检查Nacos配置文件 shared-jdbc.yaml ：

spring:
  datasource:
    url: jdbc:mysql://${hm.db.host:192.168.119.128}:${hm.db.port:3306}/${hm.db.database}?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: ${hm.db.un:root}
    password: ${hm.db.pw:123}
mybatis-plus:
  configuration:
    default-enum-type-handler: com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler
  global-config:
    db-config:
      update-strategy: not_null
      id-type: auto

检查 application.yaml 中的数据库名称：

server:
  port: 8081
hm:
  db:
    database: hm-item
  swagger:
    title: "商城商品服务接口文档"
    package: com.hmall.item.controller

检查 pom.xml 的相关依赖：

		<!--Nacos统一配置管理-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <!--读取bootstrap文件-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>

疑问：为什么要把配置参数写在 bootstrap.yaml 中，而不直接写在 application.yaml 中？

加载顺序
- bootstrap.yaml ： 在Spring Boot应用启动时， bootstrap.yaml 会先于 application.yaml 加载 。这使得Nacos配置中心的相关参数（如服务器地址、命名空间等）能在应用启动初期被读取，确保后续配置加载时Nacos已准备就绪。
- application.yaml ： application.yaml 的加载在 bootstrap.yaml 之后，适合存放应用自身的配置。
配置优先级
- bootstrap.yaml ： bootstrap.yaml 中的配置优先级高于 application.yaml ，确保Nacos配置参数不会被 application.yaml 中的配置覆盖 。
环境隔离
- bootstrap.yaml ：通常用于与环境相关的配置，如Nacos服务器地址等，便于在不同环境中切换。
- application.yaml ：适合存放与环境无关的应用配置。
配置中心集成
- bootstrap.yaml ：在集成配置中心时， bootstrap.yaml 用于指定配置中心的位置和认证信息，确保应用启动时能正确连接到配置中心并获取配置。

总结： 将Nacos配置参数放在 bootstrap.yaml 中，主要是为了确保这些配置能在应用启动初期加载，并且不会被其他配置覆盖，同时便于环境隔离和配置中心集成。