### 解决方案概述 当遇到无法连接到 Docker 容器内的 MySQL 数据库问题时，通常是因为网络配置不当或者 MySQL 配置不允许外部连接。具体错误信息 `pymysql.err.OperationalError: (2003, "Can't connect to MySQL server on 'localhost' ([Errno 111] Connection refused)")` 表明客户端尝试通过本地回环接口 (`localhost`) 连接到 MySQL 服务器失败[^1]。 为了使应用程序能够成功连接到 Docker 中的 MySQL 实例，需考虑以下几个方面： #### 修改 MySQL 的绑定地址 默认情况下，MySQL 只监听来自同一台机器上的请求（即仅限于 localhost）。如果希望允许其他设备或容器访问，则应调整其配置文件 `/etc/mysql/my.cnf` 或者 `/etc/mysql/conf.d/` 下的相关设置，将 bind-address 设置为 `0.0.0.0` 来接受任何 IP 地址发起的连接请求[^5]。 ```bash bind-address = 0.0.0.0 ``` 重启 MySQL 服务以应用更改: ```bash service mysql restart ``` #### 使用正确的主机名/IP 和端口 对于位于不同 Docker 网络下的两个容器之间的通信，应该使用目标容器的服务名称作为主机名；而对于跨物理机的情况，则应当采用实际公网可达的 IP 地址代替 `localhost`。另外需要注意的是，默认情况下 MySQL 监听的是 3306 端口，确保防火墙规则允许该端口的数据传输[^3]。 #### 创建具有适当权限的新用户并授权给特定IP范围 创建一个新的数据库账户，并赋予它足够的权限来执行所需的操作。同时指定此用户的可接入源地址，可以是一个具体的 IP 地址或者是通配符 `%`(表示任意位置)[^4]: ```sql CREATE USER 'newuser'@'%' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON *.* TO 'newuser'@'%'; FLUSH PRIVILEGES; ``` 以上措施有助于提高安全性的同时也解决了远程连接的问题。 #### 测试连通性 最后一步是在命令行工具或者其他图形界面管理软件里测试能否正常建立与 MySQL Server 的 TCP 连接。例如利用 Python 库 PyMySQL 尝试建立会话，确认参数无误之后再将其集成至项目代码之中。 ```python import pymysql.cursors connection = pymysql.connect( host='your_mysql_container_ip', user='root', password='pwd', database='testdb' ) try: with connection.cursor() as cursor: sql = "SELECT VERSION()" cursor.execute(sql) result = cursor.fetchone() finally: connection.close() print(result) ```