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

问题概述

在使用Stock项目时，许多用户遇到了数据库连接失败的问题，具体表现为"Can't connect to MySQL server"错误。这个问题在Windows原生环境、Windows Docker Desktop以及Ubuntu+Docker等多种部署方式下均有出现。

错误现象分析

从用户反馈来看，主要出现以下几种典型错误场景：

1. 直接报错"Can't connect to MySQL server on [IP]: ([Errno 111] Connection refused)"
2. 容器化部署时无法连接数据库，但宿主机直接运行Python脚本可以正常连接
3. 权限配置正确但依然连接失败

根本原因

经过分析，这些问题主要源于以下几个方面：

1. MySQL服务未运行：数据库服务可能没有正确启动
2. 网络配置问题：特别是在容器化部署时，容器与宿主机之间的网络通信可能被阻断
3. 权限设置不当：MySQL用户可能没有从特定主机连接的权限
4. 防火墙限制：系统防火墙可能阻止了数据库端口的通信

详细解决方案

1. 检查MySQL服务状态

首先确保MySQL服务正在运行：

# Linux系统
sudo systemctl status mysql

# Windows系统
检查服务管理器中MySQL服务状态

2. 容器化部署的网络配置

对于Docker部署，需要特别注意以下几点：

• 使用正确的连接地址：容器内连接宿主机MySQL时，不应使用localhost或127.0.0.1
• 网络模式选择：建议使用host网络模式或正确配置桥接网络
• 端口映射：确保MySQL端口(默认3306)已正确映射

3. 权限配置检查

确保MySQL用户有从应用服务器连接的权限：

GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

4. 防火墙设置

检查防火墙是否允许MySQL端口通信：

# Linux系统
sudo ufw allow 3306

# Windows系统
在Windows Defender防火墙中添加3306端口例外

最佳实践建议

1. 推荐使用Docker镜像：项目提供的Docker镜像已经配置好环境依赖，可以减少环境问题
2. 统一连接配置：确保应用配置中的数据库连接参数与实际环境一致
3. 日志分析：检查MySQL错误日志获取更详细的连接失败信息
4. 测试连接：使用mysql命令行工具先测试基本连接功能

总结

数据库连接问题是部署Stock项目时的常见障碍，但通过系统性的排查和正确的配置，这些问题都可以得到解决。关键在于理解不同部署方式下的网络通信机制，并确保MySQL服务的可访问性和权限设置正确。对于新手用户，建议从Docker镜像开始，逐步理解项目架构后再尝试其他部署方式。