ThinkPHP连接远程数据库需满足四大前提：MySQL服务端监听非本地地址（bind-address=0.0.0.0）、创建限定IP或@'%'的专用用户、云服务器安全组放行3306端口、ThinkPHP配置中hostname填公网IP且charset为utf8mb4。
ThinkPHP 连接远程数据库的基本前提
远程数据库不是靠“读取文件”实现的，而是通过数据库协议（如 MySQL 的 TCP 连接）建立客户端与服务端通信。ThinkPHP 本身不区分本地或远程，只关心能否连上——关键在数据库服务器是否开放了对应 IP 的访问权限、账号是否有远程登录权限、防火墙是否放行端口。
- 远程 MySQL 默认绑定
127.0.0.1，需修改my.cnf中的bind-address为0.0.0.0或具体内网/公网 IP - 用户账号必须用
CREATE USER 'user'@'%' IDENTIFIED BY 'pwd';创建（@'%'表示允许任意主机），不能只建@'localhost' - 云服务器（如阿里云、腾讯云）需在安全组中放行目标端口（默认
3306），不只是本地防火墙
在 ThinkPHP 中配置远程数据库连接
ThinkPHP 6.x 使用 config/database.php 配置多库，远程库只需把 hostname 改成对方服务器的可访问 IP 或域名，其他参数按实际填写：
'db_remote' => [
'type' => 'mysql',
'hostname' => '192.168.10.100', // 或 www.example.com
'database' => 'remote_db_name',
'username' => 'remote_user',
'password' => 'remote_pass',
'hostport' => '3306',
'charset' => 'utf8mb4',
'prefix' => '',
],
- 不要写
localhost或127.0.0.1，那是本机回环地址，连不到远程机器 - 如果远程库走的是非标端口（比如
3307），务必显式设置hostport，否则会连3306并报错Connection refused - ThinkPHP 5.1+ 默认启用 PDO 的
PDO::ATTR_EMULATE_PREPARES，远程连接慢或报错时可尝试关闭：'params' => [PDO::ATTR_EMULATE_PREPARES => false]
在代码中使用远程数据库实例
不能直接用 Db::name()，它默认走主库。必须显式指定连接配置名：
// 使用 Db 类静态调用
$result = Db::connect('db_remote')->table('users')->where('id', 1)->find();
<p>// 或用模型绑定远程库（推荐用于固定业务）
class RemoteUserModel extends Model
{
protected $connection = 'db_remote'; // 对应 config/database.php 中的键名
}
$users = RemoteUserModel::where('status', 1)->select();</p>-
Db::connect()是运行时切换，适合临时查一两个表；模型绑定$connection更清晰，也利于 IDE 跳转和后期维护 - 若远程库字段类型或 SQL 模式（如
STRICT_TRANS_TABLES）与本地不同，执行复杂查询可能报错，建议先用Db::connect(...)->query('SELECT VERSION(), @@sql_mode')探测环境差异 - 长时间未操作后首次查询超时，大概率是远程 MySQL 的
wait_timeout设置过短（默认 28800 秒），可在连接参数里加'break_reconnect' => true自动重连
调试连不上时该看什么错误
ThinkPHP 报错信息往往藏在底层 PDO 异常里，打开 app_debug = true 后重点关注：
立即学习“PHP免费学习笔记（深入）”；
-
SQLSTATE[HY000] [2002] Connection refused→ IP/端口不通，检查网络连通性（telnet 192.168.10.100 3306）、防火墙、MySQL 是否监听对外地址 -
SQLSTATE[28000] [1045] Access denied for user→ 账号密码错，或用户没被授权从当前 IP 登录（查SELECT host,user FROM mysql.user;） -
SQLSTATE[HY000] [2013] Lost connection to MySQL server→ 网络不稳定，或远程 MySQL 主动断开空闲连接，需配合break_reconnect和更短的ping保活逻辑
远程数据库跨网络意味着延迟、中断、权限粒度都比本地复杂，配置只是第一步，后续得盯着连接生命周期和错误恢复策略。
