SpringBoot项目启动失败，提示“Failed to configure a DataSource”

故障现象 某基于SpringBoot的智慧药店系统，开发人员在本地调试时，启动项目后控制台直接报错，核心提示“Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured”，项目启动失败，无法进入后续开发调试，且代码未做任何修改，前一天仍能正常启动。

### 问诊分析 结合故障现象及开发场景，排查核心方向聚焦于SpringBoot数据源自动配置逻辑，通过逐步排查得出以下结论：

1. 依赖配置异常：项目pom.xml中引入了spring-boot-starter-jdbc和spring-boot-starter-data-jpa依赖，触发SpringBoot自动配置数据源的逻辑，但未正确配置数据库连接信息，或配置信息失效。SpringBoot的自动配置特性会根据引入的依赖自动初始化相关组件，若引入数据库相关依赖却未配置数据源，就会抛出该异常。

2. 配置文件问题：检查application.yml配置文件，发现数据库连接URL格式错误，缺少“serverTimezone”参数，且驱动类配置与MySQL版本不匹配（MySQL8.0使用com.mysql.cj.jdbc.Driver，却配置为com.mysql.jdbc.Driver），导致无法加载驱动、建立数据库连接。

3. 依赖冲突：排查发现项目中同时引入了MySQL和Oracle两种数据库驱动依赖，导致SpringBoot无法确定使用哪种数据源，进而触发自动配置失败。此外，SpringBoot版本与数据库驱动版本不兼容，也会导致数据源配置失效，例如SpringBoot 2.7.x搭配MySQL驱动5.1.x，会出现驱动加载异常。

### 解决方案 针对上述问题，分步骤实施修复，确保项目正常启动：

1. 清理无效依赖：打开pom.xml文件，删除多余的Oracle驱动依赖，仅保留MySQL驱动，并确保驱动版本与MySQL版本兼容（MySQL8.0对应驱动8.0+，MySQL5.7对应驱动5.1+），添加正确的依赖配置，避免依赖冲突。

2. 修正数据源配置：在application.yml中完善数据库连接信息，规范URL格式，添加时区参数，配置正确的驱动类、用户名和密码，示例配置如下：

spring: datasource: url: jdbc:mysql://localhost:3306/pharmacy_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8&useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: true

3. 排除不必要的自动配置：若项目暂时不需要使用数据库（如仅开发静态接口），可在启动类上添加注解@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})，排除数据源自动配置，避免启动报错。

4. 验证修复效果：清理项目缓存，重新构建项目，启动SpringBoot服务，控制台无报错，显示“Started Application in xxx seconds”，说明数据源配置正常，项目启动成功。

### 规避技巧 1. 引入数据库相关依赖时，明确自身需求，避免引入多余驱动，防止依赖冲突； 2. 配置数据源时，仔细核对URL格式、驱动类、用户名和密码，尤其是MySQL8.0需注意时区参数和驱动类的变化； 3. 定期检查SpringBoot版本与依赖版本的兼容性，可通过Spring官方文档确认适配版本，避免版本不兼容问题； 4. 项目启动失败时，优先查看控制台报错信息，聚焦核心异常提示，逐步排查配置和依赖问题，提高排查效率。