Spring Boot启动失败：DataSource配置错误求助

核心问题分析 #

启动失败提示Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured及Failed to determine a suitable driver class，本质是Spring Boot无法正确加载数据库连接配置或匹配驱动类，结合你的环境（MySQL 8.0、Spring Boot 3.0.4、Java 17），按以下步骤排查：

1. 校验application.properties数据源配置 #

确保配置项完整且正确，示例配置如下：

# 替换为你的数据库名，必须指定时区参数
spring.datasource.url=jdbc:mysql://localhost:3306/your_db_name?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
# 数据库登录用户名
spring.datasource.username=root
# 数据库登录密码
spring.datasource.password=your_password
# MySQL 8.0 专属驱动类，不可用旧版替换
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

注意：

• URL必须包含serverTimezone参数，否则MySQL 8.0会抛出时区异常
• 驱动类必须使用com.mysql.cj.jdbc.Driver，旧版com.mysql.jdbc.Driver已废弃，不适配Spring Boot 3.x

2. 检查pom.xml依赖配置 #

确保引入MySQL驱动

Spring Boot 3.x推荐使用新的驱动artifactId，依赖配置示例：

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

若使用旧版artifactId，需指定兼容版本（建议8.0.28+，适配Java 17）：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
    <scope>runtime</scope>
</dependency>

确保引入数据源自动配置依赖

必须引入spring-boot-starter-data-jpa或spring-boot-starter-jdbc，否则Spring Boot不会自动初始化数据源：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

3. 环境兼容性验证 #

• MySQL 8.0 与 Spring Boot 3.0.4、Java 17 兼容，但驱动版本必须≥8.0.28，避免反射或模块访问权限问题
• 确认MySQL服务正常运行，默认端口3306未被占用，数据库用户有权限访问目标数据库

4. 其他排查点 #

• 确认application.properties放在src/main/resources目录下，Spring Boot能正常加载配置文件
• 若使用多环境配置，检查是否通过spring.profiles.active激活了正确的环境配置
• 清理Maven缓存（执行mvn clean install -U），确保依赖包完整下载

内容的提问来源于stack exchange，提问作者reek1729