Blossom项目数据库连接问题分析与解决方案

问题背景

在使用Blossom项目时，用户遇到了数据库连接失败的问题。具体表现为Docker容器中的Blossom后端服务无法连接到MySQL数据库，尽管MySQL服务本身运行正常且可以手动访问。

错误现象

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

1. 连接超时：com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure
2. 数据包未接收：The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.
3. 最终确认：无法连接到数据库IP端口 [192.168.10.22:3306]

问题分析

网络连接层面

1. 容器网络隔离：Docker容器默认使用自己的网络命名空间，可能无法直接访问宿主机网络中的MySQL服务
2. 防火墙限制：3306端口可能被防火墙阻止，导致连接请求无法到达MySQL服务
3. IP地址可达性：容器内部可能无法解析或访问指定的192.168.10.22地址

数据库配置层面

1. 用户权限限制：MySQL的root用户可能仅限localhost连接，未授权远程连接
2. 绑定地址限制：MySQL可能只绑定了127.0.0.1，未监听外部网络接口

解决方案

方案一：修改容器网络模式

docker run -d \
  --name blossom-backend \
  --network host \  # 使用宿主机网络
  -v /docker/blossom/:/home/bl/ \
  jasminexzzz/blossom:latest \
  # 其他参数保持不变

方案二：开放MySQL端口

1. 检查防火墙设置，确保3306端口对外可访问
2. 对于云服务器，还需检查安全组规则

方案三：修改MySQL用户权限

1. 登录MySQL控制台
2. 执行以下SQL命令：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'password';
CREATE USER 'root'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
FLUSH PRIVILEGES;

方案四：检查MySQL绑定地址

1. 编辑MySQL配置文件(my.cnf或my.ini)
2. 确保包含以下配置：

bind-address = 0.0.0.0

最佳实践建议

1. 专用网络：为Blossom和MySQL创建专用Docker网络，确保服务间通信隔离
2. 环境变量：使用环境变量而非命令行参数配置数据库连接
3. 连接池配置：适当调整连接池参数，如超时时间和重试次数
4. 日志监控：配置详细的日志记录，便于快速诊断连接问题

总结

Blossom项目连接MySQL数据库失败通常由网络配置或权限问题导致。通过合理配置容器网络、开放必要端口、调整MySQL用户权限等措施，可以有效解决这类连接问题。对于生产环境，建议采用专用网络和更安全的连接方式，确保服务稳定性和数据安全性。