Spring Boot 服务依赖 MySQL 启动失败，怎么办？

Spring Boot服务依赖MySQL启动失败是开发过程中经常遇到的问题，这类故障通常和依赖、配置、环境状态等多个维度相关，需要逐步排查定位根因。

常见启动失败原因及排查方案

1. 依赖引入错误

如果项目中没有正确引入MySQL驱动依赖，或者依赖版本和Spring Boot版本不兼容，就会导致启动失败。首先需要检查pom.xml（Maven项目）或build.gradle（Gradle项目）中的依赖配置。

Maven项目正确的MySQL驱动依赖示例（以MySQL 8.x为例）：

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

如果是Spring Boot 2.7及以上版本，也可以不指定驱动版本，让Spring Boot自动管理适配版本：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

2. 数据库连接配置错误

连接配置错误是最常见的原因，需要检查application.yml或application.properties中的MySQL相关配置项。

正确的application.yml配置示例：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/test_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

需要重点检查以下几个配置项：

• url：确认IP地址、端口、数据库名称是否正确，参数是否完整，尤其是serverTimezone参数，MySQL 8.x版本必须指定时区，否则会报错。
• username/password：确认数据库账号密码是否正确，是否有对应数据库的访问权限。
• driver-class-name：MySQL 8.x版本需要使用com.mysql.cj.jdbc.Driver，5.x版本使用com.mysql.jdbc.Driver，版本不匹配会导致驱动加载失败。

3. MySQL服务未正常运行

如果MySQL服务本身没有启动，或者端口被占用，Spring Boot服务也无法连接成功。可以先检查MySQL服务状态：

Linux系统检查命令：

# 检查MySQL服务状态
systemctl status mysql
# 如果未启动，执行启动命令
systemctl start mysql

Windows系统可以在服务列表中查看MySQL服务是否处于运行状态，或者执行以下命令检查3306端口是否被监听：

netstat -ano | findstr 3306

4. 数据库权限不足

如果配置的数据库账号没有对应数据库的访问权限，也会导致连接失败。可以登录MySQL执行以下命令赋予权限：

-- 赋予root用户从任意主机访问test_db数据库的所有权限，密码为123456
GRANT ALL PRIVILEGES ON test_db.* TO 'root'@'%' IDENTIFIED BY '123456';
-- 刷新权限
FLUSH PRIVILEGES;

通用排查步骤

如果以上场景都排查后还是无法启动，可以按照以下步骤逐步定位问题：

1. 查看启动日志，找到具体的报错信息，报错信息通常会明确提示是驱动问题、连接问题还是权限问题。
2. 先尝试用本地MySQL客户端使用配置文件中的账号密码连接数据库，确认数据库本身可以正常访问。
3. 检查项目中是否有多套配置文件，确认启动加载的是正确的配置文件。
4. 如果是新搭建的项目，可以先简化配置，只保留最基本的MySQL连接参数，逐步添加其他配置排查是否有冲突。

总结

Spring Boot依赖MySQL启动失败的核心排查思路是先看日志定位错误类型，再分别检查依赖、配置、MySQL服务状态、权限这几个维度，大部分问题都可以通过这几个步骤解决。日常开发中建议把MySQL连接配置中的敏感信息放到环境变量或配置中心中，避免配置错误导致的问题。

Spring_BootMySQL启动失败依赖配置修改时间：2026-07-08 15:12:29