Spring Boot应用出现SQLException数据库访问拒绝的解决方法

Spring Boot应用出现SQLException数据库访问拒绝是开发中常见的异常问题，通常会直接导致应用无法正常连接数据库，影响业务功能运行。

常见异常表现

当数据库访问被拒绝时，控制台通常会抛出类似如下的异常信息：

java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:129)
    at com.mysql.cj.jdbc.exceptions.SQLExceptionsMapping.translateException(SQLExceptionsMapping.java:122)
    ...

这类异常的核心提示就是访问被拒绝，接下来我们逐步排查问题。

排查与解决步骤

1. 检查数据源配置是否正确

首先确认application.yml或application.properties中的数据库连接配置是否有误，这是最常见的原因。

以MySQL为例，正确的yml配置示例如下：

spring:
  datasource:
    # 数据库驱动类，MySQL8及以上使用这个
    driver-class-name: com.mysql.cj.jdbc.Driver
    # 连接地址，注意ip、端口、数据库名是否正确
    url: jdbc:mysql://127.0.0.1:3306/test_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
    # 数据库用户名
    username: root
    # 数据库密码，注意是否有特殊字符需要转义
    password: 123456

需要重点检查url中的ip地址、端口、数据库名是否和实际环境一致，用户名和密码是否填写正确，如果密码包含特殊字符比如@、#，需要在yml中用单引号包裹。

2. 验证数据库用户权限

如果配置没有问题，需要检查数据库用户是否有对应库的访问权限。可以登录数据库执行如下命令查看用户权限：

-- 查看root用户在localhost的权限
SHOW GRANTS FOR 'root'@'localhost';
-- 如果没有对应库权限，授权给test_db库
GRANT ALL PRIVILEGES ON test_db.* TO 'root'@'localhost';
-- 刷新权限
FLUSH PRIVILEGES;

如果是远程连接数据库，需要确认用户是否允许对应ip访问，比如允许所有ip访问可以创建用户时指定'root'@'%'。

3. 检查数据库服务与网络连通性

确认数据库服务是否正常运行，可以通过以下命令检查：

• Windows：在cmd中执行net start mysql查看服务状态
• Linux：执行systemctl status mysql查看服务运行状态

如果数据库部署在远程服务器，还需要检查本地到数据库服务器的网络是否通畅，可以执行ping 数据库ip和telnet 数据库ip 端口验证连通性。

4. 检查依赖是否匹配

确认项目中引入的数据库驱动依赖和数据库版本匹配，比如MySQL8需要使用8.x版本的驱动，5.x版本数据库使用5.x驱动，错误的依赖也可能导致连接失败。

Maven依赖示例：

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

总结

遇到Spring Boot的SQLException数据库访问拒绝问题，按照配置检查、权限验证、网络排查、依赖匹配的顺序逐步排查，大部分问题都可以快速解决。如果以上步骤都检查无误还是有问题，可以开启数据库慢查询日志或者Spring Boot的debug日志，查看更详细的连接过程信息来定位问题。

Spring_BootSQLException数据库访问拒绝数据源配置修改时间：2026-05-30 23:41:59