thinkphp多库配置中hostport必须为整数（如3306、5432），不可为空或字符串；键名必须是hostport，不能是port或db_port，且每个connections子项需独立显式配置，否则pdo静默回退至默认端口导致连错实例。
ThinkPHP多库配置里hostport写成字符串或留空
多库场景下，每个connections子项的hostport必须是整数，比如3306、5432，不能是'3306'或空值。框架不会 fallback 到默认端口，也不会自动类型转换——写成字符串会导致 PDO 构造失败，错误常表现为PDOException: SQLSTATE[HY000] [2002] Connection refused，但实际 MySQL 服务可能正跑在非标端口上。
常见翻车点：
- 复制主库配置改从库时，只改了
hostname，漏掉hostport，结果从库连到了主库端口 - 用
env()读取.env里的DB_HOSTPORT=3307，却没强制转整型：'hostport' => env('DB_HOSTPORT', 3306)→ 值是字符串'3307'，应写成'hostport' => (int)env('DB_HOSTPORT', 3306) - PostgreSQL 连接误填
3306（MySQL 默认），而实际服务监听5432；SQL Server 用sqlsrv驱动时漏配1433
Db::connect()动态连接时port键名写错或漏传
运行时调用Db::connect()传数组，必须显式带hostport（不是port或DB_PORT），且值为整数。这个参数不继承全局配置，也不做任何合并——漏写就回退到 PDO 默认的3306，哪怕你其他库都配对了也没用。
正确写法示例：
Db::connect([
'type' => 'mysql',
'hostname' => '10.0.1.5',
'hostport' => 3307, // 必须是整数，键名必须是 hostport
'database' => 'backup_db',
'username' => 'reader',
'password' => 'xxx'
]);
容易踩的坑：
- 键名写成
'port'或'DB_PORT'，框架直接忽略，静默 fallback 到3306 - 值用
env('DB_PORT')没转整型，传进去的是字符串，PDO 初始化失败 - 在事务或长连接复用场景下调用
Db::connect()，但没重置hostport，导致后续查询连错端口
云数据库（如阿里云 RDS）端口不匹配却没察觉
阿里云 RDS、腾讯云 CDB 等云服务常使用非标端口（如3307、5432、1433），而本地开发习惯性填3306。问题不是“连不上”，而是“连上了但连错实例”——比如主从共用一个 IP，仅靠端口区分，填错就查到主库去了，数据一致性立刻出问题。
排查建议：
- 进云控制台确认实例实际端口，别信文档默认值
- 用
telnet rds-hostname 3307或nc -zv rds-hostname 3307直连验证端口可达性 - 检查
connections里每个库的hostname和hostport是否成对匹配，尤其注意主从、读写分离、备份库等不同用途的连接项
ThinkPHP 6+ 的hostport字段名必须写对
ThinkPHP 6 及以上版本，数据库配置中端口字段固定叫hostport，不是port、DB_PORT，也不是server_port。写错键名等于没配，框架完全无视，PDO 就用默认3306发起连接。
典型错误配置：
// ❌ 错误：键名不对，值也可能是字符串
'port' => '3307',
// ❌ 错误：用环境变量但没转整型
'hostport' => env('DB_PORT'),
// ✅ 正确：键名对 + 整数
'hostport' => (int)env('DB_PORT', 3306),
特别注意：hostport只出现在config/database.php的connections数组里，不在params或dsn中；如果用了 DSN 字符串方式连接，端口要直接写进 DSN，和hostport无关。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
