校园茅台项目MySQL连接问题分析与解决方案

问题背景

在部署校园茅台项目(campus-imaotai)的V1.0.11版本时，部分用户遇到了campus-server无法连接MySQL数据库并自动退出的问题。具体表现为服务启动后不久即停止运行，日志中显示"Host '172.22.0.4' is not allowed to connect to this MySQL server"的错误信息。

问题现象

1. 使用docker-compose up -d命令启动服务后，campus-server容器会在一段时间后自动停止
2. 查看日志发现MySQL连接被拒绝的错误
3. 前端页面无法正常显示验证码
4. 该问题在多次清理容器和镜像后重新部署仍然存在

问题分析

根本原因

该问题的核心在于MySQL数据库的访问权限配置不当。具体表现为：

1. MySQL服务器未正确配置允许来自Docker容器内部IP(172.22.0.4)的连接
2. 默认用户权限可能仅限本地访问(localhost或127.0.0.1)
3. 在Docker环境中，容器间的网络通信需要明确的权限配置

技术细节

MySQL的安全机制会限制来自特定主机的连接请求。当使用Docker部署时，每个容器会被分配独立的IP地址，而默认的MySQL安装可能不会自动允许这些IP的连接。

解决方案

方法一：修改MySQL用户权限

1. 登录MySQL服务器：

docker exec -it campus-mysql mysql -uroot -p

2. 查看现有用户权限：

SELECT user, host FROM mysql.user;

3. 授予适当权限：

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

4. 退出并重启MySQL服务

方法二：检查MySQL绑定地址

1. 编辑MySQL配置文件(通常位于/etc/mysql/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf)
2. 确保bind-address设置为0.0.0.0(允许所有IP连接)或注释掉该行
3. 重启MySQL服务使更改生效

方法三：使用环境变量配置

在docker-compose.yml中，可以明确指定MySQL的连接参数：

environment:
  MYSQL_ROOT_PASSWORD: yourpassword
  MYSQL_ROOT_HOST: '%'

预防措施

1. 在项目文档中明确说明MySQL的配置要求
2. 提供标准的docker-compose模板，包含正确的权限设置
3. 在启动脚本中加入权限检查步骤

经验总结

1. Docker环境中的数据库连接问题通常与网络配置和权限相关
2. MySQL的默认安全设置可能过于严格，需要根据实际环境调整
3. 自动化部署脚本应考虑各种环境差异，增加必要的配置步骤

通过以上解决方案，大多数用户能够成功解决校园茅台项目的MySQL连接问题，确保服务正常运行。对于类似项目，建议在部署前仔细检查数据库的访问权限配置，避免类似问题的发生。