Spring Cloud Alibaba 项目中DataSource 配置失败？原来是 application.yml 和 bootstrap.yml 的坑

文章目录

一、问题背景
二、第一反应：数据库配置有问题？
[三、关键现象：换成 bootstrap.yml 就好了](#三、关键现象：换成 bootstrap.yml 就好了)
[四、核心原因：Spring Boot 配置加载顺序](#四、核心原因：Spring Boot 配置加载顺序)
[五、为什么 bootstrap.yml 能解决问题？](#五、为什么 bootstrap.yml 能解决问题？)
六、正确且推荐的配置方式
七、为什么这个坑这么"隐蔽"？
八、补充：新版本的替代方案
九、总结

问题现象

同样的数据库配置：

写在 application.yml 中 → 启动失败

改成 bootstrap.yml → 一切正常

报错却是：
复制代码
Failed to configure a DataSource
url attribute is not specified

很多人第一反应是 数据库、MySQL、驱动、Nacos ，但其实------
问题根本不在这里。
深入理解 PropertySource 与优先级：Spring Boot/Spring Cloud 配置体系的底层原理

一、问题背景

在一个 Spring Cloud Alibaba + Nacos + MyBatis-Plus 项目中：

使用 Nacos Config 作为配置中心
数据源（DataSource）配置放在 Nacos
本地配置文件中启用了 dev 环境

但项目启动时直接失败，报错如下：

text 复制代码

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

二、第一反应：数据库配置有问题？

于是开始常规排查：

✔ MySQL 服务正常
✔ Nacos 能正常访问
✔ Nacos 中存在 sky-aiReport-dev.yml
✔ spring.datasource.url / username / password 都写了
✔ MyBatis-Plus、HikariCP 依赖齐全

但就是启动不了。

三、关键现象：换成 bootstrap.yml 就好了

后来做了一个简单但关键的尝试：

👉 把 Nacos 相关配置从 application.yml 移到 bootstrap.yml

结果：

❌ application.yml → 启动失败
✅ bootstrap.yml → 启动成功

这说明：不是配置内容的问题，而是配置"加载时机"的问题。

四、核心原因：Spring Boot 配置加载顺序

1️⃣ Spring Boot + Spring Cloud 的加载顺序（简化）

text 复制代码

bootstrap.yml        （引导阶段，最早）
↓
Nacos Config         （依赖 bootstrap）
↓
application.yml
↓
application-dev.yml
↓
Bean 创建（DataSource / MyBatis）

2️⃣ 问题就出在这里

如果你把 Nacos 连接信息 写在：

yaml 复制代码

application.yml

那么流程会变成：

Spring Boot 开始创建 Bean
DataSourceAutoConfiguration 被触发
此时 Nacos 配置还没加载
Spring 发现没有 spring.datasource.url
❌ 直接启动失败

所以你看到的是 DataSource 错误 ，

但真实原因是：Nacos 配置加载得太晚了。

五、为什么 bootstrap.yml 能解决问题？

因为 bootstrap.yml 的设计目的就是：

在 Spring 容器初始化之前，加载外部配置中心的信息

当你使用 bootstrap.yml：

Spring 先读取 bootstrap.yml
确定应用名、profile、Nacos 地址
从 Nacos 拉取配置
拿到 spring.datasource
再开始创建 DataSource

👉 顺序正确，启动自然成功

六、正确且推荐的配置方式

1️⃣ bootstrap.yml（只放"引导配置"）

yaml 复制代码

spring:
  application:
    name: sky-aiReport
  profiles:
    active: dev
  cloud:
    nacos:
      discovery:
        server-addr: 192.168.121.140:8848
      config:
        server-addr: 192.168.121.140:8848
        file-extension: yml
        shared-configs:
          - application-${spring.profiles.active}.yml

bootstrap.yml 的职责：

应用名

环境 profile

配置中心地址

2️⃣ Nacos：sky-aiReport-dev.yml

yaml 复制代码

spring:
  datasource:
    url: jdbc:mysql://192.168.121.140:3306/sky-report
    username: root
    password: 123456

mybatis-plus:
  mapper-locations: classpath*:mapper/**/*Mapper.xml

3️⃣ application.yml（尽量简单）

yaml 复制代码

server:
  port: 9301

七、为什么这个坑这么"隐蔽"？

原因有三点：

❗ 报错是 DataSource
❗ 实际问题是 配置加载顺序
❗ 单体项目用 application.yml 完全没问题

只有在：

Spring Cloud + Nacos + 数据源配置放在配置中心

这个组合下，问题才会暴露。

八、补充：新版本的替代方案

在 Spring Boot 2.4+ / Spring Cloud 2021+ 中，官方推荐：

yaml 复制代码

spring:
  config:
    import: nacos:

可以 不再使用 bootstrap.yml。

但在：

老项目
大部分公司项目
Spring Cloud Alibaba 场景

👉 bootstrap.yml 仍然是最稳定、最不容易出错的方案

九、总结

✅ DataSource 本身没问题

✅ Nacos 配置也没问题

❌ 问题在 application.yml 加载得太晚

👉 Spring Cloud 项目中，涉及 Nacos 的"引导配置"，必须放在 bootstrap.yml

当你在 Spring Cloud 项目中看到 DataSource 配置错误时，
先别急着怀疑数据库，
很可能只是------配置文件放错了地方。