### 可能的原因分析 当尝试通过 Python 连接 MySQL 数据库时，连接失败通常由以下几个常见原因引起： 1. **用户权限不足**：如果用户的权限未正确设置，则可能导致无法成功建立连接[^1]。 2. **驱动程序缺失或版本不匹配**：缺少必要的数据库驱动程序（如 `pymysql` 或 `mysql-connector-python`），或者其版本与当前使用的 Python 版本不兼容[^3]。 3. **网络配置错误**：目标数据库所在的服务器可能不允许远程访问，防火墙规则也可能阻止了连接请求。 --- ### 解决方案 #### 1. 检查并修正用户权限 确保已为指定的 MySQL 用户分配足够的权限。可以通过以下 SQL 命令完成： ```sql GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES; ``` 此命令允许该用户从任何主机 (`%`) 访问数据库，并赋予所有必要权限[^1]。 #### 2. 安装合适的数据库驱动 确认已经安装了适合的数据库驱动程序。对于 MySQL 数据库，推荐使用 `pymysql` 或者官方支持的 `mysql-connector-python`。可以运行以下命令来安装这些包之一： ```bash pip install pymysql # 或者 pip install mysql-connector-python ``` 如果遇到安装问题，也可以手动下载 `.whl` 文件进行本地安装[^4]。 #### 3. 修改 Python 的连接字符串 以下是基于 `pymysql` 库的一个标准连接示例代码片段： ```python import pymysql try: connection = pymysql.connect( host='localhost', # 替换为目标数据库地址 user='your_username', # 使用具有适当权限的用户名 password='your_password', database='your_db_name' ) with connection.cursor() as cursor: sql_query = "SELECT * FROM some_table LIMIT 10" cursor.execute(sql_query) result = cursor.fetchall() except Exception as e: print(f"Error connecting to the database: {e}") finally: if connection.open: connection.close() ``` 注意替换占位符部分的实际值以适配具体场景需求。 #### 4. 调整 MySQL 配置文件 (可选) 有时需要修改 MySQL 的配置文件 `/etc/mysql/my.cnf` 来启用外部访问功能。找到 `[mysqld]` 下面的一行 `bind-address=127.0.0.1` 并将其更改为 `bind-address=0.0.0.0` 后重启服务即可生效[^1]。 另外还需验证是否有其他安全机制(例如 SELinux)干扰正常通信流程。 --- ### 总结 综上所述，Python 连接 MySQL 失败的主要原因是由于权限设定不当、缺乏正确的驱动器以及潜在的网络障碍所致。按照上述方法逐一排查应该能够有效解决问题。