ThinkPHP5 whereRaw 跨库子查询三重坑：表前缀消失 + 别名失效

某后台管理系统需要用企业微信的标签 ID 过滤联系人列表。数据分布在两个数据库，通过 Db::connect('database.crm_content') 切换连接，然后用 whereRaw 拼 IN 子查询。代码写起来行云流水，上线却直接崩：SQLSTATE[42S02]: Base table or view not found，紧接着 SQLSTATE[42S22]: Unknown column 'c.external_userid' in 'where clause'。两个报错轮番出现，花了将近两小时才定位到根因。

现象

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

或者改完之后变成：

SQLSTATE[42S22]: Unknown column 'c.external_userid' in 'where clause'

明明外层 ->table('contact')->alias('c') 已经写了，子查询里也引用了 c.external_userid，偏偏数据库认不出来。

根因

TP5 的 ORM 存在三个彼此叠加的行为，踩全了就是上面的两条报错。

第一坑：whereRaw 不自动注入表前缀。 TP5 的 table_prefix 自动填充只作用于 builder 链式调用（->table()、->join()、->where() 里的字段名）。一旦你把 SQL 字符串传进 whereRaw，框架原封不动地透传给 PDO，前缀一个字符都不补。如果配置里 prefix = 'crm_'，那 whereRaw 里写 tag 实际执行的就是 FROM tag，表名缺前缀当然找不到。

第二坑：跨库连接自带前缀配置隔离。 调用 Db::connect('database.crm_content') 会加载另一套数据库配置，前缀可能与默认连接不同。即使外层 ->table() 能自动补，whereRaw 里的表名也完全不受这个前缀配置约束。跨库场景下最安全的做法是在 whereRaw 里永远写完整表名（含前缀），不依赖任何自动注入。

第三坑：子查询是独立作用域，外层别名不可见。 SQL 标准里，子查询有自己独立的 FROM 子句，外层 alias('c') 定义的 c 在内层 SELECT 里根本不存在。写 c.external_userid 在子查询的 WHERE/SELECT 里会直接报 Unknown column。

坑：whereRaw 里的表名 TP5 不管，外层别名子查询里不认

// 错误示例：短表名 + 外层别名同时出现在 whereRaw 子查询
Db::connect('database.crm_content')
    ->table('contact')->alias('c')
    ->whereRaw("c.external_userid IN (
        SELECT external_userid
        FROM tag
        WHERE tag_id IN ({$tagIds}) AND c.external_userid = external_userid
    )")
    ->select();
// 报错 1：Table 'crm_content.tag' doesn't exist（前缀没补）
// 报错 2：Unknown column 'c.external_userid'（子查询不认外层别名）

正解

两条规则同时执行：

whereRaw 内部所有表名必须写完整带前缀的名字（crm_tag 而非 tag）。
子查询里只用裸列名（external_userid），不加外层表别名前缀；如果真需要关联过滤，写在外层 WHERE 而非子查询内部。

正解：whereRaw 内写完整表名，子查询只用裸列名

Db::connect('database.crm_content')
    ->table('crm_contact')->alias('c')
    ->whereRaw("c.external_userid IN (
        SELECT external_userid
        FROM crm_tag
        WHERE tag_id IN ({$tagIds})
    )")
    ->select();
// crm_tag 完整带前缀，子查询里无外层别名，两个报错都消失

附：绑定参数比字符串插值更安全

如果 $tagIds 来自用户输入或外部系统，用绑定占位符替代字符串拼接：

->whereRaw(
    "c.external_userid IN (SELECT external_userid FROM crm_tag WHERE tag_id IN (?,?))",
    [$tagId1, $tagId2]
)

TP5 的 whereRaw 第二个参数接收绑定数组，传给 PDO prepared statement，完全规避注入风险。

验证方式

开启 TP5 SQL 日志（config/database.php 中 'debug' => true），tail runtime log 确认实际执行 SQL 中表名已带前缀，子查询里没有 c. 前缀的列引用。

一句话外卖

whereRaw 是 ORM 的逃生舱，一旦进去，前缀注入和别名作用域的一切自动化保证都失效——永远写完整表名，子查询只用裸列名。