### 解决 Python 在 Windows 系统上连接 MySQL 数据库时报错 2003 的问题 当在 Windows 上使用 Python 连接到 MySQL 数据库时，如果出现 `2003` 错误（即 `(2003, "Can't connect to MySQL server on '%s:%d' (%s)" % (self.host, self.port, err)`），这表明客户端无法成功建立与 MySQL 服务器的连接。以下是可能导致此错误的原因及解决方案： --- #### 1. **MySQL 服务未启动** 如果目标主机上的 MySQL 服务未正常运行，则会触发该错误。可以按照以下步骤验证并解决问题： - 打开命令提示符，输入以下命令检查 MySQL 服务状态： ```cmd net start | findstr /i "mysql" ``` - 如果未找到相关服务，请手动启动 MySQL 服务： ```cmd net start mysql ``` 此外，也可以通过 Windows 服务管理器启动 MySQL 服务。 --- #### 2. **网络配置问题** 如果 MySQL 主机地址设置不正确或防火墙阻止了通信，也可能导致此错误。以下是解决方法： - **Ping 测试**：确保可以从本地计算机 Ping 通目标 MySQL 服务器 IP 地址或域名。 ```cmd ping <MySQL_Server_IP> ``` - **修改绑定地址**：默认情况下，MySQL 绑定到 `localhost`（即 `127.0.0.1`）。如果需要允许远程访问，需编辑 MySQL 配置文件 `my.ini` 或 `my.cnf`，并将 `bind-address` 设置为目标 IP 地址或 `0.0.0.0`（表示监听所有接口）[^1]。 ```ini [mysqld] bind-address = 0.0.0.0 ``` - 修改完成后，重启 MySQL 服务以使更改生效。 --- #### 3. **端口冲突或未开放** 默认情况下，MySQL 使用的是 3306 端口。如果该端口被其他程序占用或因安全策略关闭，则会导致连接失败。以下是排查和解决的方法： - **检查端口占用情况**：在 PowerShell 中运行以下命令，查看是否存在进程占用了 3306 端口： ```powershell Get-NetTCPConnection | Where-Object {$_.LocalPort -eq 3306} ``` - **修改 MySQL 端口**：如果确实存在冲突，可以在 MySQL 配置文件中将 `port` 参数更改为其他未使用的端口号，并重启服务使其生效[^2]。 ```ini [mysqld] port = 3308 ``` --- #### 4. **用户权限不足** 即使网络配置无误，如果 MySQL 用户没有足够的权限从特定主机连接，仍然会出现类似错误。以下是解决方法： - 登录 MySQL 控制台，执行以下 SQL 查询，授予用户从任意主机连接的权限（假设用户名为 `root`，密码为 `password`）： ```sql GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; ``` - 注意：这里的 `'%'` 表示允许来自任何主机的连接。如果仅希望允许局域网内的某台设备连接，可以用具体的 IP 地址替代 `%`。 --- #### 5. **DNS 解析问题** 如果 MySQL 客户端尝试解析主机名而非直接使用 IP 地址，可能会因为 DNS 配置问题导致连接失败。以下是解决方法： - 将主机名替换为实际的 IP 地址进行连接测试。例如，在 Python 中使用以下代码： ```python import pymysql connection = pymysql.connect( host="127.0.0.1", # 替换为主机的实际 IP 地址 user="root", password="password", database="test_db", charset="utf8mb4", cursorclass=pymysql.cursors.DictCursor ) with connection.cursor() as cursor: sql = "SELECT VERSION()" cursor.execute(sql) result = cursor.fetchone() print(result) ``` - 如果仍报错，考虑禁用反向 DNS 查找功能。在 MySQL 配置文件中添加以下参数并重启服务： ```ini [mysqld] skip-name-resolve ``` --- #### 6. **SSL/TLS 认证问题** 如果启用了强制 SSL/TLS 加密连接，而客户端未提供有效的证书，也可能导致连接失败。以下是解决方法： - 检查是否需要加载特定的 SSL 证书。如果是，确保在连接字符串中指定正确的路径。例如： ```python connection = pymysql.connect( host="127.0.0.1", user="root", password="password", database="test_db", ssl={"ca": "/path/to/ca-cert.pem"} ) ``` - 如果不需要 SSL，可在连接时显式禁用它： ```python connection = pymysql.connect( host="127.0.0.1", user="root", password="password", database="test_db", ssl_disabled=True ) ``` --- #### 7. **驱动兼容性问题** 如果使用的是较新的 MySQL 版本（如 8.x），默认的身份验证插件可能为 `caching_sha2_password`，而某些旧版客户端库（如 `MySQLdb`）可能不支持这种身份验证方式。以下是解决方法： - 更改用户的默认身份验证插件为 `mysql_native_password`： ```sql ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'password'; FLUSH PRIVILEGES; ``` - 或者升级客户端库至最新版本，例如安装 `pymysql` 或 `mysql-connector-python`： ```bash pip install pymysql mysql-connector-python ``` --- ### 示例代码 以下是一个完整的 Python 脚本示例，用于测试与 MySQL 的连接： ```python import pymysql try: connection = pymysql.connect( host="127.0.0.1", # 替换为实际的 MySQL 服务器地址 user="root", password="password", database="test_db", charset="utf8mb4", cursorclass=pymysql.cursors.DictCursor, ssl_disabled=True # 如果无需 SSL，可启用此选项 ) with connection.cursor() as cursor: sql = "SELECT VERSION()" cursor.execute(sql) version = cursor.fetchone() print(f"MySQL Version: {version}") except pymysql.MySQLError as e: print(f"Error connecting to MySQL Platform: {e}") finally: if 'connection' in locals() and connection.open: connection.close() ``` ---