### Python 连接 MySQL 常见问题及解决方案 在使用 Python 操作 MySQL 数据库时，可能会遇到多种错误情况。以下是针对常见问题的具体分析和解决方法： #### 1. 密码包含特殊字符导致连接失败 当密码中包含 `@` 或其他特殊字符时，可能导致解析异常并引发错误。可以通过 URL 编码的方式处理密码中的特殊字符[^1]。 ```python import urllib.parse password = "your_password_with_@" encoded_password = urllib.parse.quote_plus(password) connection_string = f"mysql+pymysql://username:{encoded_password}@host:port/database" ``` 通过上述方式可以有效避免因密码中含有特殊字符而导致的连接问题。 --- #### 2. 用户权限不足或认证失败 如果出现 `(1045, 'Access denied for user ...')` 错误，则可能是用户名或密码不匹配，或者该用户未被授权访问指定主机上的数据库[^2]。 - **验证用户名和密码**：确认输入的用户名和密码无误。 - **检查用户权限**：登录 MySQL 并执行以下命令以授予必要权限： ```sql GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES; ``` 此操作允许用户从任何 IP 地址 (`%`) 访问数据库。 --- #### 3. 数据库不存在 `(1049, "Unknown database 'XXXX'")` 表明尝试连接的数据库名称不存在[^3]。 - 验证目标数据库是否存在： ```sql SHOW DATABASES; ``` - 如果数据库确实缺失，请创建它： ```sql CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` 确保后续代码中使用的数据库名与此一致。 --- #### 4. 网络连接问题 如果服务器返回 `(2003, "Can't connect to MySQL server...")`，则可能涉及网络配置或服务状态问题[^1][^5]。 - **检查 MySQL 服务是否运行正常**：确保本地或远程 MySQL 实例已启动。 Windows 下可通过以下命令查看服务状态： ```cmd net start | findstr /i mysql ``` 若服务未开启，可手动启动： ```cmd net start mysql ``` - **防火墙设置**：确认端口（默认为 3306）未被阻止。 - **绑定地址**：编辑 MySQL 的配置文件（通常位于 `/etc/mysql/my.cnf`），修改 bind-address 参数以便支持外部访问： ```ini bind-address = 0.0.0.0 ``` 随后重启 MySQL 服务使更改生效。 --- #### 5. SQLAlchemy 使用示例 基于提供的参考资料[^4]，下面是一个完整的 SQLAlchemy 示例用于连接 MySQL 数据库： ```python from sqlalchemy import create_engine import pandas as pd # 构建连接字符串 engine = create_engine('mysql+pymysql://username:password@host:port/database') # 执行查询并将结果加载至 DataFrame query = "SELECT * FROM table_name;" df = pd.read_sql(query, engine) print(df.head()) ``` 注意替换占位符部分的实际值，并按照前述建议调整编码后的密码或其他参数。 --- ### 总结 以上涵盖了多个典型场景下的排查思路与修复措施。实际应用过程中需结合具体环境逐一测试直至定位根本原因。