根本原因是容器与宿主机网络隔离且MySQL默认拒绝外部连接；容器内localhost指向自身，需改用host.docker.internal（Win/macOS）或配置bind-address=0.0.0.0、授权远程用户并开放防火墙。

根本原因不是“连不上”，而是容器和宿主机在不同网络平面，且 MySQL 默认拒绝外部 TCP 连接。

容器里写 localhost 实际连的是自己

这是最常踩的坑。Docker 容器启动后，localhost 指向容器内部的回环地址（127.0.0.1），而宿主机的 MySQL 服务根本不在这个容器里运行。

• Spring Boot 配置 jdbc:mysql://localhost:3306/mydb → 容器内尝试连接自己 3306 端口，失败
• PHP 脚本用 mysqli_connect('localhost', ...) → 同样走容器内部 socket/TCP，无服务监听
• 正确做法：把 localhost 换成能指向宿主机的地址

host.docker.internal 是 Windows/macOS 的快捷解法

Docker Desktop 为 Windows 和 macOS 内置了 DNS 名 host.docker.internal，它会自动解析为宿主机的网关 IP（如 172.17.0.1）。

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• Java/Go/Python 等应用中，把数据库 host 改成 host.docker.internal
• Docker Compose 中可显式声明（避免 Linux 兼容问题）：extra_hosts: ["host.docker.internal:host-gateway"]
• Linux 用户不支持该 DNS，默认不生效；若强行使用需手动添加 --add-host 或改用 --network=host

MySQL 本身默认只绑 127.0.0.1，拒绝外部连接

即使你用了正确的 host 地址（比如 192.168.1.100），如果宿主机 MySQL 的 bind-address 仍为 127.0.0.1，它会直接丢弃所有来自容器的 TCP 请求。

• 检查配置文件（Windows：C:\ProgramData\MySQL\MySQL Server 8.0\my.ini；Linux：/etc/mysql/mysql.conf.d/mysqld.cnf）
• 确认存在 bind-address = 0.0.0.0 或至少 bind-address = 192.168.1.100（非 127.0.0.1）
• 改完必须重启 MySQL 服务：sudo systemctl restart mysql 或 net stop mysql80 && net start mysql80
• 防火墙也要放行对应端口（Windows Defender / ufw / 云服务器安全组）

用户权限只允许 user@localhost，不认容器 IP

MySQL 的权限是按 'user'@'host' 组合判断的。你创建的 root@localhost 只接受 Unix socket 连接，对容器发来的 TCP 请求（来源 IP 如 172.17.0.1）完全无效。

• 登录宿主机 MySQL 执行：CREATE USER 'myapp'@'%' IDENTIFIED BY 'mypass';
• 再授权：GRANT ALL ON mydb.* TO 'myapp'@'%'; FLUSH PRIVILEGES;
• 生产环境慎用 %，应明确限定来源 IP 段，例如 'myapp'@'172.17.%'
• 注意：localhost 在 MySQL 里是特殊值，不等于 127.0.0.1，也不匹配任何 IP —— 它强制走本地 socket

真正卡住人的地方，往往不是单点问题，而是多个环节同时失效：容器配错 host、MySQL 没开 bind、用户没授远程权、防火墙又拦了一道。建议按「网络可达性 → MySQL 监听状态 → 权限匹配」顺序逐层验证，别一上来就调权限。