JeecgBoot项目MySQL连接错误的排查与解决方案

问题背景

在使用JeecgBoot 3.7.1版本进行后端项目启动时，开发者遇到了数据库连接错误。错误信息显示MySQL服务器拒绝了root用户的连接请求，尽管密码是正确的。这是一个典型的数据库访问权限问题，在Java项目开发中较为常见。

错误现象分析

从错误日志中可以清晰地看到以下关键信息：

ERROR com.alibaba.druid.pool.DruidDataSource:2930 - create connection SQLException
url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8&useUnicode=true&useSSL=false&tinyInt1isBit=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
errorCode 1045, state 28000
java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)

错误代码1045表示MySQL服务器拒绝了客户端的连接请求，状态码28000进一步确认了这是一个认证失败的问题。

可能的原因

1. 密码不匹配：配置文件中指定的密码与MySQL服务器中root用户的实际密码不一致
2. 主机限制：MySQL服务器可能限制了root用户只能从特定主机连接
3. Docker环境问题：如果项目运行在Docker环境中，localhost/127.0.0.1可能指向容器本身而非宿主机
4. 用户权限不足：root用户可能没有访问jeecg-boot数据库的权限

解决方案

1. 验证MySQL凭据

首先确认application.yml或application-dev.yml等配置文件中指定的数据库用户名和密码是否正确。可以尝试使用MySQL命令行客户端使用相同凭据连接数据库进行验证。

2. 检查用户权限

登录MySQL服务器后执行以下命令检查root用户的权限：

SELECT host, user FROM mysql.user WHERE user = 'root';

如果发现root用户仅允许从特定主机连接，可以修改权限或创建新用户：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;

3. Docker环境特殊处理

在Docker Compose环境中，需要特别注意以下几点：

• 将配置中的127.0.0.1替换为Docker服务名（如jeecg-boot-mysql）
• 确保MySQL容器已正确启动并暴露了3306端口
• 检查网络配置，确保应用容器和MySQL容器在同一网络中

4. 多环境配置检查

JeecgBoot项目通常包含多个环境的配置文件，需要确保修改了所有相关文件：

• application-dev.yml（开发环境）
• application-test.yml（测试环境）
• application-prod.yml（生产环境）

最佳实践建议

1. 避免使用root用户：在生产环境中，建议为应用创建专用数据库用户并授予最小必要权限
2. 统一配置管理：考虑使用Spring Cloud Config或Nacos等配置中心统一管理数据库连接信息
3. 连接池调优：合理配置Druid连接池参数，如initialSize、maxActive、minIdle等
4. 环境隔离：确保开发、测试、生产环境使用独立的数据库实例

总结

JeecgBoot项目启动时的MySQL连接错误通常源于配置与实际情况不匹配。通过系统地检查数据库用户权限、验证连接参数、适应容器化环境特点，可以有效地解决这类问题。理解错误背后的原理并采取适当的预防措施，将有助于提高开发效率和系统稳定性。