MySQL远程连接失败90%因服务端未放行：需检查bind-address是否为0.0.0.0、用户是否按IP显式授权（如' tp8_user '@'203.0.113.45'）、端口3306是否通（telnet测试），并避免localhost解析陷阱及caching_sha2_password认证插件不兼容问题。
ThinkPHP8 连不上远程 MySQL，90% 的情况不是代码写错了，而是 MySQL 服务端压根没“放行”——mysqli_connect() 或 PDO 报错 Host 'x.x.x.x' is not allowed to connect 时，别急着改 PHP 配置，先去数据库服务器上查三件事：监听地址、用户权限、端口通路。
MySQL 服务端必须监听外部 IP（bind-address）
默认安装的 MySQL 只绑定了 127.0.0.1，意味着它拒绝所有来自其他机器的连接请求。这不是 ThinkPHP 的锅，是 MySQL 自身配置锁死的。
- 编辑配置文件（常见路径：
/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/my.cnf），找到bind-address行，改为：bind-address = 0.0.0.0 - 重启服务：
sudo systemctl restart mysql - 验证是否生效：
sudo netstat -tlnp | grep :3306—— 输出中应含*:3306，而非127.0.0.1:3306
必须创建带来源 IP 限定的用户（不能只改 user 表 host 字段）
用 UPDATE user SET host = '%' 直接宽泛授权 root，既不安全，GCP/AWS/腾讯云等平台的安全组还会直接拦截该操作。实际部署中应显式声明可信客户端 IP。
- 登录 MySQL（仅限数据库服务器本地）：
mysql -u root -p - 创建用户（例如 PHP 应用服务器 IP 是
203.0.113.45）：CREATE USER 'tp8_user'@'203.0.113.45' IDENTIFIED BY 'strong_password'; - 授权（最小权限原则）：
GRANT SELECT, INSERT, UPDATE ON mydb.* TO 'tp8_user'@'203.0.113.45'; - 刷新权限：
FLUSH PRIVILEGES;
ThinkPHP8 的 .env 配置要避开 localhost 解析陷阱
即使 MySQL 允许远程连接，若你在 .env 中写 DB_HOST=localhost，PHP 仍可能走 Unix socket 而非 TCP，导致连接失败或认证方式不匹配（尤其 MySQL 8.0+）。
立即学习“PHP免费学习笔记（深入）”；
- 强制使用 IPv4 地址：
DB_HOST=192.168.10.100（替换成你的 MySQL 服务器公网或内网 IP） - 指定字符集：
DB_CHARSET=utf8mb4，避免中文乱码 - 确认端口正确：
DB_PORT=3306（若改过端口需同步） - 检查
config/database.php是否正确读取了env()，关键字段应类似："hostname" => env("DB_HOST", "127.0.0.1")
MySQL 8.0 用户认证插件不兼容时要降级 plugin
ThinkPHP8 默认用 PDO 连接，而 MySQL 8.0 新建用户默认用 caching_sha2_password 插件，老版本 PHP（如 7.4 或未更新 pdo_mysql 扩展的 8.0+）会报 Authentication plugin 'caching_sha2_password' cannot be loaded。
- 登录 MySQL 后执行：
SELECT user, host, plugin FROM mysql.user WHERE user = 'tp8_user'; - 若 plugin 是
caching_sha2_password，执行：ALTER USER 'tp8_user'@'203.0.113.45' IDENTIFIED WITH mysql_native_password BY 'strong_password'; - 再次
FLUSH PRIVILEGES; - 注意：该操作不影响安全性，只是让旧驱动能握手成功
真正卡住的地方往往在中间层：云平台安全组规则比本地防火墙更优先拦截 3306；DB_HOST 填了域名但 DNS 解析失败；或者 PHP 容器网络无法路由到 MySQL 服务器 IP。建议先在 ThinkPHP 服务器上用 telnet your-mysql-ip 3306 或 nc -zv your-mysql-ip 3306 确认端口可达，再动代码。
