bind-address必须写成无引号、无空格的纯IPv4地址(如192.168.1.100),不可用localhost、带引号或尾部空格;该IP须真实配置在网卡上,否则启动失败或静默回退;监听指定IP后127.0.0.1连接失效;MySQL 8.0.13+支持逗号分隔多IP列表,但禁用通配符且各IP必须真实存在。

bind-address 必须写成无引号、无空格的纯 IPv4 地址
MySQL 8.0 的 bind-address 不接受字符串字面量,写成 "192.168.1.100"、192.168.1.100 (尾部空格)或 localhost 都会导致启动失败。错误日志里通常出现 Invalid argument 或 unknown variable 'bind-address='。
正确写法只有:bind-address = 192.168.1.100。这个 IP 必须是服务器上某块网卡实际配置的地址——运行 ip addr show 能查到它;否则 MySQL 可能静默回退到 127.0.0.1,或直接拒绝启动。
监听指定 IP 后 localhost 连接会彻底失效
设成 bind-address = 192.168.1.100 意味着 MySQL 只监听该网卡的 TCP 端口,不再监听 127.0.0.1:3306。即使本机用 mysql -h 127.0.0.1 -u root 也会被拒绝,因为请求发到了回环接口,而服务根本没在那里监听。
- 运维脚本或监控工具若硬编码了
-h 127.0.0.1,会突然连不上 - Docker 容器内应用若通过宿主机 IP 连,但容器网络无法路由到该内网 IP(例如桥接模式下只能走
host.docker.internal) - 本地调试需求未被覆盖:想同时支持内网访问和本机 CLI 调试,不能靠
bind-address“多选”解决
真正可行的方案只有两个:bind-address = 0.0.0.0 + 严格限制用户权限(如 'user'@'192.168.1.%'),或者改所有客户端连接地址为该指定 IP。
MySQL 8.0.13+ 才支持逗号分隔的多 IP 列表
如果你确认版本 ≥ 8.0.13(运行 SELECT VERSION(); 验证),且必须监听多个确定 IP(比如 192.168.1.100 和 10.0.2.15),可写成:
bind-address = 192.168.1.100,10.0.2.15
但注意:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 列表中不能含通配符:
0.0.0.0、*、::全部非法 - 每个 IP 必须真实存在且已配置在对应网卡上(
ip addr show可见) - 低于 8.0.13 的版本(包括很多生产环境部署的 8.0.2x/8.0.3x)不识别该语法,会直接启动失败
验证监听是否真生效,别信配置文件写了就完事
改完配置、执行 sudo systemctl restart mysql 后,唯一可信的验证方式是检查系统级 socket 监听状态:
sudo ss -tlnp | grep :3306
你期望看到的是类似:
LISTEN 0 70 192.168.1.100:3306 *:* users:(("mysqld",pid=12345,fd=34))
而不是 127.0.0.1:3306 或 *:3306。如果没看到目标 IP,说明配置未生效——常见原因是:配置被其他 [mysqld] 段覆盖、!include 引入的额外文件干扰、或服务根本没重启成功(systemctl status mysql 查看实际状态)。
多网卡场景下最容易被忽略的点:IP 绑定是网卡级行为,不是“逻辑网络”级。如果用了 bond/team 聚合,要确保绑定后的虚拟网卡(如 bond1)已配置目标 IP,并且该 IP 出现在 ip addr show 输出中——MySQL 不认路由表,只认直连网卡地址。










