ThinkPHP 跨库 leftJoin 静默返回 null，用两步查询+PHP 内存合并替代

某后台管理系统拆库之后，有个列表接口突然"正常但不正常"：HTTP 200、分页数据都对，唯独用户昵称和头像字段全是空字符串。查数据库，数据明明在；单独查关联表，字段有值。一个 leftJoin 写法，在本地单库环境跑得好好的，一上分库 staging 就悄悄坏掉了。

现象

$rows = Db::name('feedback')
    ->alias('f')
    ->leftJoin('mini_user u', 'f.user_id = u.openid')
    ->field('f.*, u.nickname, u.avatar')
    ->select()
    ->toArray();
// 返回的每行 nickname / avatar 都是 null

有时还会直接报错：

SQLSTATE[42S02]: Base table or view not found: 1146 Table 'db_main.mini_user' doesn't exist

明明 mini_user 在另一个 database db_user 里，ThinkPHP 却把它拼进了主库名前缀。

根因

ThinkPHP 5/6/8 的 Db::name() / Db::connect() 每个连接对应一条持久 PDO。leftJoin 的 SQL 由当前连接的 catalog 名拼接生成，ORM 的 name builder 不处理 db1.table 的跨库限定符。

当 feedback 表在 db_main，mini_user 在 db_user，驱动连接是 db_main，拼出来的 SQL 就是：

SELECT f.*, u.nickname, u.avatar
FROM db_main.feedback f
LEFT JOIN db_main.mini_user u ON f.user_id = u.openid
-- ↑ 前缀错了，应该是 db_user.mini_user

MySQL 找不到 db_main.mini_user，要么报表不存在，要么静默 JOIN 失败返回 null 行——后者才是最危险的，因为不报错、不抛异常、数据看起来完整，只是字段悄悄变空。

坑：跨库 leftJoin 不报错但字段全 null

ThinkPHP 的 ORM 不会在 SQL 层面自动处理跨 database 的表前缀，也不会在运行时警告你。表面上查询成功、行数正确，实际上关联表的所有字段已静默失效。本地单库开发永远暴露不了这个问题，只有拆库之后才会中招。

正解

把一个跨库 JOIN 拆成两步独立查询，在 PHP 内存里用 array_column 做 map 合并：

// 第一步：主表查询（当前连接的 database）
$rows = Db::name('feedback')
    ->where('deleted', 0)
    ->order('id', 'desc')
    ->page($page, $size)
    ->select()
    ->toArray();
 
if (empty($rows)) {
    return [];
}
 
// 第二步：收集关联 key（去重、过滤空值）
$openids = array_values(array_unique(array_filter(array_column($rows, 'user_id'))));
 
// 第三步：用另一个连接查关联表
$userMap = [];
if (!empty($openids)) {
    $userMap = Db::connect('db_user')          // 显式指定另一个连接
        ->name('mini_user')
        ->whereIn('openid', $openids)
        ->column('nickname,avatar', 'openid'); // openid => ['nickname'=>..., 'avatar'=>...]
}
 
// 第四步：PHP 内存合并
foreach ($rows as &$row) {
    $u = $userMap[$row['user_id']] ?? [];
    $row['nickname'] = $u['nickname'] ?? '';
    $row['avatar']   = $u['avatar']   ?? '';
}
unset($row);
 
return $rows;

关键点：column('nickname,avatar', 'openid') 直接返回以 openid 为 key 的关联数组，合并时 O(1) 查找，不需要嵌套循环。

正解：两步查询 + PHP map 合并，绕开 catalog 命名空间问题

每个 Db::connect()/Db::name() 只操作自己连接的 database，不再依赖 ORM 拼跨库前缀。每页数据量可控时（通常 ≤ 1000 条），单次 whereIn 的网络开销远小于一次全表跨库扫描。

多跳场景

如果需要多级关联（A 表 → B 表 → C 表，且三张表跨库），重复这个模式：每一跳都是「收集 key → 按 key 批量查 → 合并」，不要尝试用 ORM 链式 join 跨越 database 边界。

一句话外卖

ThinkPHP 跨 database 的 leftJoin 是静默炸弹——拆成两步读 + PHP map 合并，每个连接只看自己的 catalog，才是分库后唯一可靠的关联写法。