Hyperf的QueryBuilder多表JOIN报错主因是字段引用不规范：必须先from()再join()最后select()，跨表字段须加表前缀（如'users.name'），JOIN条件含函数需用onRaw()；LEFT JOIN过滤应写在on()而非where()，count()和分页需用count('users.id')防膨胀，禁用select('*')避免字段覆盖。
Hyperf里用QueryBuilder写多表JOIN为什么总报错？
因为Hyperf的QueryBuilder默认不支持直接链式调用join()后立刻用select()引用别名字段——它底层用的是PDO预处理，而表别名在FROM子句之后才生效，但很多开发者会先select('users.name')再join('profiles')，导致字段解析失败。
- 必须先声明
from()或table()主表，再join()，最后select() - 所有跨表字段必须显式加表前缀，如
'users.id'、'profiles.avatar'，不能只写'id' - 如果JOIN条件含函数（如
DATE(created_at)），得用whereRaw()或onRaw()，普通on()只支持等值列对比
如何正确写LEFT JOIN并避免N+1和空结果问题？
Hyperf的QueryBuilder不会自动处理NULL关联行，比如用户没填资料时LEFT JOIN profiles会返回profiles.*全为NULL，但如果你在select()里写了'profiles.avatar as avatar'，那结果里这个avatar就是null，不是缺失字段——这点常被当成“查不到数据”。
- 用
selectRaw("COALESCE(profiles.avatar, '/default.png') as avatar")兜底默认值 - 避免在
WHERE里写profiles.status = 1，这会让LEFT JOIN退化成INNER JOIN；真要过滤关联表，得把条件挪进on()：->on('profiles.user_id', '=', 'users.id')->on('profiles.status', '=', 1) - 批量查100个用户及其资料，不要循环执行100次
QueryBuilder，改用whereIn('users.id', $ids)一次拉取主表，再用whereIn('profiles.user_id', $ids)一次拉取副表，应用层合并
多表JOIN时count()和分页为什么不准？
Hyperf的paginate()底层调用count()时，默认只统计SELECT *的行数，但JOIN后可能一行主表数据对应多行副表数据，导致count(*)膨胀。比如1个用户有3条订单，JOIN orders后count(*)返回3，但你想要的是“用户数”，不是“用户×订单数”。
- 分页前先用
count('users.id')指定去重主键计数：$query->count('users.id') - 或者手动分离：先
select('users.id')->distinct()->get()拿到ID列表，再用这些ID查详情，适合数据量不大时 - 慎用
groupBy('users.id')来辅助count——它会影响后续select()字段，且MySQL严格模式下要求SELECT所有非聚合字段都在GROUP BY中
复杂查询字段冲突和性能怎么兼顾？
当多张表都有id、created_at字段，又想全选（select('*')），Hyperf不会自动加别名，结果集里只会保留最后一个同名列的值，前面的被覆盖。
- 永远不用
select('*')，明确列出需要的字段，并统一加前缀：select('users.id as user_id', 'profiles.id as profile_id') - JOIN超过3张表且涉及大字段（如
TEXT）时，先用select('users.*')查主表，再按需with()关联模型——虽然with()是Eloquent风格，但Hyperf的Model类仍可配合QueryBuilder混用 - EXPLAIN确认执行计划：如果
type是ALL或rows远超预期，检查JOIN字段是否都建了索引，特别是ON条件里的列
最易被忽略的一点：Hyperf的QueryBuilder不缓存SQL执行计划，每次调用都会重新解析语法树。如果同一个复杂JOIN查询高频调用，建议把最终SQL字符串提取出来，用Db::statement()或原生PDO复用，而不是反复构造QueryBuilder实例。
