ThinkPHP5的with()不支持跨库关联，因MySQL不支持跨实例JOIN且TP未实现跨库SQL拼接；需手动分三步：查主表、查从表、PHP层映射合并，并注意连接名严格匹配、字段重命名防覆盖。
跨库关联不能用 with() 自动处理
ThinkPHP5 的 with() 预加载只在单库内有效。哪怕你给两个模型分别设了 $connection = 'log_db' 和 $connection = 'main_db'，调用 User::with('login_log')->select() 时，框架仍会尝试用 User 模型的连接去查 login_log 表——结果要么报错 Table 'main_db.login_log' doesn't exist，要么查到空数据。
根本原因：MySQL 不支持跨实例 JOIN，TP 也没做跨库 SQL 拼接。所谓“关联”，只是 PHP 层的数据组装。
- 别指望
with()跨库返回嵌套对象 - 不要在关联方法里写
return $this->hasOne('Log', ..., 'log_db')——hasOne()不接受连接名参数 - 若强行在
hasOne里调用Db::connect('log_db')，会导致该关联无法被with()识别（反射失败）
belongsTo 和 hasOne 写反是静默故障高发点
比如用户表 user 有字段 org_id，组织表 organisation 是主表。这时 User 模型应定义 belongsTo('Organisation', 'org_id')，而不是 hasOne。写反后不会报错，但 $user->organisation 始终为 null。
实操要点：
立即学习“PHP免费学习笔记（深入）”；
-
belongsTo必须显式传外键字段名，如'org_id'；不传则默认找organisation_id，字段名一换就失效 -
hasOne默认用当前模型主键（id）去匹配关联表的外键，如果关联表用的是sn字段，就得加localKey：->hasOne('Profile', 'user_sn', 'sn') - 模型方法名建议用业务语义命名，如
organisation()，别用rel1()—— 后续加with('organisation')时才不会看懵
手动跨库关联的三步落地法
真实场景：查 user（main_db）和其操作日志 login_log（log_db），按时间倒序分页展示。
正确做法不是拼 SQL，而是分三步在 PHP 层合并：
- 第一步：查主表
Db::connect('main_db')->name('user')->where($where)->field('id,name,email')->order('id desc')->paginate(20) - 第二步：提取 ID 列表
$userIds = array_column($users->items(), 'id')，再查日志Db::connect('log_db')->name('login_log')->where('user_id', 'in', $userIds)->select() - 第三步：用
collection或循环做映射，注意重命名冲突字段（如两表都有id）：$logMap = group_by($logs, 'user_id')，然后遍历用户补上$user['logs'] = $logMap[$user['id']] ?? []
性能提示：日志表若超 10 万行，第二步要用 limit 控制批量大小，避免内存溢出。
配置多库时 connections 键名必须严格匹配
Db::connect('log_db') 能跑通的前提，是 config/database.php 的 connections 数组里明确定义了 'log_db' => [...]。任何偏差都会失败：
-
Db::connect('log.db')❌ —— 点号不被解析，抛出Connection not found -
Db::connect('LogDB')❌ —— 大小写敏感，配置里是'logdb'就不匹配 -
Db::connect(['hostname' => '...'])❌ —— 每次新建 PDO 实例，压测时 MySQL 很快报Too many connections
.env 里只能扁平定义变量，比如 logdb_hostname=192.168.1.11，然后在 database.php 中拼进 connections['log_db']，漏写 'type' => 'mysql' 会导致驱动加载失败，报错看似是 PDO not found，实则是扩展没启用或类型配置缺失。
跨库字段合并时最容易忽略的，是同名字段覆盖 —— 比如主表和日志表都叫 id，直接 array_merge() 会丢数据，必须提前用 AS 重命名或 PHP 层加前缀。
