bind-address必须为无引号无空格的纯ipv4地址（如192.168.1.100），且该ip须真实存在于网卡上；设为此值后localhost连接失效，推荐用0.0.0.0配合防火墙与用户host限制实现安全访问。
bind-address 必须写成纯 IPv4 地址，不能带引号或空格
MySQL 8.0 对 bind-address 的格式极其敏感：只接受形如 192.168.1.100 的裸地址字符串。写成 "192.168.1.100"、192.168.1.100 （尾部空格）、localhost 或 192.168.1.0/24 都会导致启动失败，日志中出现 Invalid argument 或 unknown variable 'bind-address='。
常见翻车点：
- 运维脚本自动生成配置时拼接了引号
- 从其他文档复制粘贴，带上了不可见 Unicode 空格
- 误用 CIDR 表示法（MySQL 不解析子网掩码）
该 IP 必须已实际配置在某块网卡上
运行 ip addr show，确认输出里真有你写的那个地址。如果网卡后来被 DHCP 改了 IP，但 bind-address 没同步更新，MySQL 可能静默回退到 127.0.0.1（不报错但监听不对），也可能直接启动失败。
特别注意：
- 不要写 Docker 容器内网 IP（如
172.17.0.2），宿主机网卡上不存在这个地址 - 不要写 Kubernetes Pod IP，同理
- 若使用 bond/team 聚合网卡，IP 是配在
bond0上的，bind-address就填那个地址
设为内网 IP 后，localhost 连接会失效
bind-address = 192.168.1.100 意味着 MySQL 只绑定那块物理网卡，不再监听 127.0.0.1。此时执行 mysql -h 127.0.0.1 -u root 会连接拒绝——不是权限问题，是 TCP 层根本没监听那个地址。
所以必须同步处理本地访问需求：
- 开发/运维脚本硬编码了
-h 127.0.0.1？得改成-h 192.168.1.100或用 Unix socket（-S /var/run/mysqld/mysqld.sock） - 容器内应用连宿主机 MySQL？确保容器网络能路由到该内网 IP（比如用
host.docker.internal或--network host） - 想保留本地调试能力？不如改用
bind-address = 0.0.0.0+ 用户权限控制（'user'@'192.168.1.%'）+ 防火墙限源
多网卡场景下，别依赖 bind-address 实现“双 IP”
MySQL 8.0.12 及更早版本的 bind-address 仅支持单值；8.0.13+ 才支持逗号分隔（如 192.168.1.100,127.0.0.1），但每个地址都必须真实存在且不能含通配符。
实际中更可靠的做法是：
- 设
bind-address = 0.0.0.0 - 用防火墙精确放行内网段：
ufw allow from 192.168.1.0/24 to any port 3306 - 创建用户时严格限定 host：
CREATE USER 'app'@'192.168.1.%' IDENTIFIED BY 'pwd'; - 删掉匿名用户：
DROP USER ''@'%';
这种组合比死磕 bind-address 多 IP 更稳定，也更容易审计和排查——毕竟 bind 是网络层绑定，而访问控制应该分层做，不能全压在一个配置项上。
