JeecgBoot项目MySQL连接访问被拒绝问题分析与解决方案

问题背景

在使用JeecgBoot 3.7.1版本进行后端项目启动时，开发者遇到了数据库连接问题。系统日志显示Druid连接池创建连接时出现SQLException异常，具体错误信息为"Access denied for user 'root'@'localhost' (using password: YES)"，错误代码1045，状态28000。

错误原因深度解析

这个错误表明应用程序尝试使用root用户和提供的密码连接到本地MySQL服务器时被拒绝访问。这种情况通常由以下几个原因导致：

1. 认证凭据不匹配：application配置文件中指定的数据库用户名或密码与MySQL服务器中设置的不一致
2. 用户权限不足：MySQL中的root用户可能没有从localhost访问特定数据库的权限
3. 网络配置问题：当使用Docker等容器化环境时，localhost可能指向容器本身而非宿主机

解决方案详解

方案一：检查并修正数据库凭据

1. 打开项目中的application配置文件(如application-dev.yml)
2. 确认以下配置项正确：

   spring:
     datasource:
       url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8
       username: root
       password: 你的实际密码
   

3. 确保密码与MySQL服务器中设置的root用户密码完全一致

方案二：MySQL权限调整（适用于本地开发环境）

1. 使用MySQL命令行客户端登录：

   mysql -u root -p
   

2. 执行以下SQL命令检查用户权限：

   SELECT host, user FROM mysql.user;
   

3. 如果发现权限问题，可以尝试授权：

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY '你的密码';
   FLUSH PRIVILEGES;
   

方案三：容器化环境特殊处理（Docker Compose场景）

在Docker Compose环境中，需要特别注意服务间的网络通信：

1. 将配置文件中所有127.0.0.1地址替换为对应的服务名称：

   • MySQL地址：127.0.0.1:3306 → jeecg-boot-mysql:3306
   • Redis地址：127.0.0.1 → jeecg-boot-redis

2. 需要修改的配置文件包括：

   • 各微服务模块的application.yml
   • 系统启动模块的各种环境配置文件(dev/test/prod等)

最佳实践建议

1. 环境隔离：为不同环境(开发/测试/生产)使用独立的数据库用户和密码
2. 密码管理：避免在代码库中直接存储生产环境密码，考虑使用环境变量或配置中心
3. 连接池调优：合理配置Druid连接池参数，如初始连接数、最大连接数等
4. 日志监控：启用SQL日志监控，便于及时发现连接问题

总结

JeecgBoot项目启动时的MySQL连接拒绝问题通常源于配置不匹配或权限不足。通过仔细检查数据库连接配置、验证用户权限，以及在容器化环境中正确配置服务地址，可以有效解决此类问题。建议开发者在项目初期就建立规范的数据库配置管理流程，避免因环境差异导致的连接问题。