ThinkPHP 5.1 的 join() 不会自动推导表别名，必须显式声明；漏写、错写或混用别名会导致字段解析失败且静默返回空结果。正确写法为 'order o' 或 ['order' => 'o']，field()/where() 中字段必须带别名前缀，主表 alias() 需在 join() 前调用，LEFT JOIN 过滤条件须置于 ON 而非 WHERE，调试务必用 buildSql() 核查三处别名一致性。
ThinkPHP 5.1 的 join() 不会自动推导表别名，漏写、错写或混用别名会导致字段解析失败——但框架往往静默返回空结果，而不是报错。
join() 必须在第一个参数里显式带别名
字符串形式的 join() 必须写成 'order o' 这样带空格+别名的结构，不能只写 'order' 或 'order as o'。框架靠这个空格切分表名和别名，as 关键字会被忽略甚至引发解析异常。
- 正确：
->join('order o', 'u.id = o.user_id') - 错误：
->join('order', 'u.id = order.user_id')（字段无前缀，TP 无法识别归属） - 错误：
->join('order as o', ...)（as被当作文本拼进 SQL，生成FROM user INNER JOIN order as o ON ...，MySQL 报错）
二维数组写法更安全：->join(['order' => 'o'], 'u.id = o.user_id')，它绕过字符串解析，也避免前缀自动拼接问题（比如关联无前缀系统表时）。
field() 和 where() 中的字段必须带别名前缀
一旦用了别名，所有字段引用都得带上——包括 field()、where()、order()、group()。TP 不会帮你补前缀，也不会警告你漏了。
立即学习“PHP免费学习笔记（深入）”；
- 主表别名由
alias()设置，且必须在join()之前调用：->table('user')->alias('u')->join('order o', ...) -
field('u.name, o.no')是 OK 的；field('name, no')或field('user.name, order.no')都会失效 -
where('o.status', 'paid')可以；where('status', 'paid')会被当成主表字段，查不到数据也不报错
多表同名字段（如 id、create_time）必须显式重命名，否则 PHP 数组里后一个会覆盖前一个：field('u.id AS user_id, o.id AS order_id')。
LEFT JOIN 条件必须写在 ON，不能塞进 WHERE
把过滤条件误放 WHERE 会导致 LEFT JOIN 退化为 INNER JOIN，丢失左表无匹配的记录。
- 正确（保留所有用户，不管有没有订单）：
->leftJoin('order o', 'u.id = o.user_id')->where('o.status', 'paid')❌ 错！这会让没订单的用户也被过滤掉 - 正确写法：
->leftJoin('order o', 'u.id = o.user_id AND o.status = "paid"')✅ ON 里写右表条件 - 或者拆开：
->leftJoin('order o', 'u.id = o.user_id')->where('o.status', 'paid')❌ 依然错，必须用AND放 ON 里
注意：如果右表字段可能为 NULL（比如 o.status），WHERE o.status = 'paid' 会直接剔除 NULL 行，等价于强制 INNER JOIN。
调试时一定要看 buildSql() 生成的真实 SQL
别猜，直接输出：echo Db::table('user')->alias('u')->join('order o', 'u.id = o.user_id')->field('u.name, o.no')->buildSql();。重点核对三处：
-
FROM user u—— 主表别名是否出现 -
LEFT JOIN order o ON u.id = o.user_id—— 每个 JOIN 的别名是否一致、ON 里字段是否带前缀 -
SELECT u.name, o.no—— SELECT 字段是否全部带别名，有没有裸字段
只要有一处不一致，就可能查不到数据或字段错位。跨数据库项目（比如迁移到 PostgreSQL）尤其要严查，它比 MySQL 更早、更严格地报 column "id" is ambiguous。
