withCount不能用于一对一关联，错用会静默返回0；正确做法是确认关联类型、改用with预载或判断是否存在，闭包条件须写在withCount内且仅限关联表字段，注意类型强转与JSON输出配置。
withCount 不能用于一对一关联，错用会静默返回 0
很多人在定义 User 模型的 profile()（一对一）后，直接写 withCount('profile')，结果拿到的 profile_count 总是 0，也不报错。这是因为 withCount 底层依赖 GROUP BY + COUNT(*)，而一对一关联无法分组统计——它只期望一条记录，框架干脆跳过子查询，填个默认 0。
正确做法是：
- 确认关联方法是否为一对多（如
comments()）或多对多（如roles()） - 若真需统计一对一是否存在，改用
with(['profile' => function ($q) { $q->field('id'); }])，然后判断$user->profile !== null - 别名写法如
withCount(['profile' => 'has_profile'])在一对一场景下依然无效，不会改变静默行为
闭包条件必须写在 withCount 内部，否则条件错位
想查「已审核的评论数」，如果这么写：User::withCount('comments')->where('comments.status', 1)->select()，SQL 会报错或结果完全不对——因为主表 users 并没有 comments.status 字段。
真正生效的写法只有这一种：
立即学习“PHP免费学习笔记（深入）”；
User::withCount(['comments' => function ($query) {
$query->where('status', 1);
}])->select();
注意点：
- 闭包内只能写关联表字段，不能出现主表字段（如
id、name） - 支持链式多个条件：
$query->where('status', 1)->where('is_deleted', 0) - 禁止调用
select()、order()、limit()—— 这些会破坏 COUNT 子查询结构 - TP 5.0.7+ 支持别名 + 闭包，但部分版本存在 bug（别名被忽略），建议优先保障条件逻辑，别名仅作可选优化
withCount 和 with 混用时 SQL 不共享，大表慎用
写 User::with('comments')->withCount('comments')->find(1) 看似方便，实际会执行两条独立子查询：一条 SELECT * FROM comments WHERE user_id = ?，另一条 SELECT COUNT(*) FROM comments WHERE user_id = ?。即使逻辑相同，也不会自动合并为 JOIN 或复用结果。
性能敏感场景要警惕：
- 当
comments表超 10 万行，with()拉全量 +withCount()再 COUNT，不如拆成两个明确请求更可控 - 分页时
paginate()会先跑一次 COUNT 查询（含所有withCount子查询），再跑一次 SELECT（同样含子查询），相当于同条件执行两次 - 若只需数量不要详情，就只用
withCount()；若需详情且数量只是辅助展示，可考虑在循环中用$user->comments->count()（已预载入前提下）
统计值类型不可靠，数值比较前务必强转
withCount 返回的属性（如 $user->comments_count）类型取决于数据库驱动返回值。MySQLi 可能返回 string，PDO 可能返回 int，var_dump 看不出区别，但 if ($user->comments_count > 0) 在某些环境会因类型隐式转换出错。
安全写法始终是：
if ((int) $user->comments_count > 0) {
// 有评论
}
其他易忽略点：
- 该属性是动态添加的，不在模型的
$visible/$hidden列表里，JSON 输出时默认不包含，需手动append(['comments_count']) - 自定义别名（如
withCount(['comments' => 'comm_num'])）后，必须用$user->comm_num，$user->comments_count就不存在了 - 事务中使用
withCount时，子查询读取的是事务快照还是最新数据，取决于数据库隔离级别，高并发下可能看到“未提交”的关联记录计数
