Spring Cloud + Nacos 项目启动失败：别再被 "No spring.config.import property has been defined" 困扰了！
2024-01-28 08:26:56
Spring Cloud + Nacos：告别 "No spring.config.import property has been defined" 的烦恼
背景
Spring Cloud 与 Nacos 的组合已成为微服务架构的主流选择，但不少开发者在启动项目时遇到了一个棘手的报错："No spring.config.import property has been defined"。本文将深入剖析这一问题并提供彻底的解决方案，帮助你轻松解决这个难题。
问题根源
自 Spring Cloud 2020.0.x 版本起，不再默认启用 Bootstrap 包。这意味着之前常用的 bootstrap.yaml 配置文件将不再被自动加载。而 Bootstrap 包的作用是让 Spring Boot 在启动时加载一些关键配置，如数据源、日志级别等。
解决方案
解决这个问题的方法有两个：
1. 显式导入 bootstrap.yaml 配置文件
在 application.yaml 或 application.properties 文件中添加以下配置：
spring:
config:
import: file:bootstrap.yaml
2. 将配置信息移动到 application.yaml 或 application.properties
将 bootstrap.yaml 中的配置信息移动到 application.yaml 或 application.properties 文件中，Spring Boot 会自动加载它们。
代码示例
以下是一个 application.yaml 文件的示例，包含了 bootstrap.yaml 中的配置信息：
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/mydb
username: root
password: 123456
logging:
level:
org.springframework.web: DEBUG
成功启动
完成上述操作后，你的 Spring Cloud + Nacos 项目即可顺利启动，告别恼人的 "No spring.config.import property has been defined" 错误。
温馨提示
- 在进行上述操作前，请备份你的配置信息以防万一。
- 如果你的 Spring Cloud 版本低于 2020.0.x，则无需进行上述操作。
常见问题解答
Q1：为什么 Spring Cloud 不再默认启用 Bootstrap 包？
A：为了简化 Spring Boot 的启动流程，默认情况下仅加载必要的配置。
Q2：bootstrap.yaml 文件中的配置信息有哪些？
A：通常包括数据源、日志级别、环境变量等关键配置。
Q3：将配置信息移动到 application.yaml 或 application.properties 文件后，bootstrap.yaml 文件是否还有用？
A：如果不需要在启动时加载特定的配置，则可以删除 bootstrap.yaml 文件。
Q4：是否可以同时使用两种解决方案？
A：不建议这样做，因为会造成配置冗余和冲突。
Q5：如果我使用的是其他 Spring Boot 版本，如何解决这个问题？
A：对于 Spring Boot 1.x 版本，在 application.properties 文件中添加以下配置：
spring.config.import: file:bootstrap.yaml
