withCount() 必须用闭包显式指定条件（如status=1）才能按状态过滤统计，否则默认统计全部关联记录；仅对hasMany/belongsToMany有效，需注意外键类型、软删除及NULL值处理。
withCount() 本身不支持直接按状态字段过滤统计，必须用闭包显式写条件，否则查出来的全是 0 或全表计数。
withCount 配合闭包才能统计 status = 1 的关联数量
ThinkPHP 的 withCount() 默认统计所有关联记录，不会自动识别主模型的 where 条件，更不会帮你加 status = 1 这类业务过滤。你得主动把条件塞进闭包里。
- 错误写法：
withCount('orders')→ 统计全部 orders，不管 status - 正确写法：
withCount(['orders' => function ($q) { $q->where('status', 1); }])→ 只统计 status 为 1 的订单数 - 闭包必须写在数组键值对里，不能链式追加：
withCount('orders')->where('status', 1)是无效的，条件不会下推到子查询 - 如果关联表启用了软删除（如
delete_time字段），记得一并过滤：$q->whereNull('delete_time')->where('status', 1)
一对多关联是前提，一对一调 withCount 会静默失效
withCount() 只对 hasMany() 和 belongsToMany() 关联生效。如果你在 hasOne() 或 belongsTo() 上调用，框架不会报错，但返回的 xxx_count 属性永远是 0 或不存在。
- 检查模型中是否正确定义了关联方法：比如
User::orders()必须返回$this->hasMany(Order::class) - 别名拼写要完全一致：
withCount('Orders')（首字母大写）或withCount('orderss')都会导致查不到，属性为空 - 外键类型不匹配也会导致“查得到数据但 count 为 0”：比如
User.id是BIGINT，而Order.user_id是INT，MySQL 会隐式转成 0 匹配，结果自然没记录
自定义别名防冲突，避免多个 withCount 覆盖同名属性
当你同时统计多个带条件的关联时，比如用户下的「已支付订单数」和「已发货订单数」，都用 orders_count 就会互相覆盖。
立即学习“PHP免费学习笔记（深入）”；
- 用数组语法指定别名：
withCount(['orders' => 'paid_orders_count'])和withCount(['orders' => 'shipped_orders_count'])是非法的——同一个关联不能重复声明 - 正确做法是拆成两个独立闭包：
withCount(['paid_orders' => function ($q) { $q->where('status', 'paid'); }])和withCount(['shipped_orders' => function ($q) { $q->where('shipping_status', 'shipped'); }]) - 这样生成的属性分别是
paid_orders_count和shipped_orders_count，互不干扰 - 调试时可执行
Db::getLastSql()看生成的子查询是否各自独立、别名是否唯一
NULL 值和软删除不处理，统计结果就不可信
哪怕只有一条关联记录的 status 是 NULL，或者被软删除了，withCount() 默认仍会把它算进去——因为 COUNT(*) 不忽略 NULL，但你业务上往往不想要它。
- 显式排除 NULL：
$q->where('status', '', null)或更稳妥地用$q->whereNotNull('status') - 软删除必须手动过滤：
$q->whereNull('delete_time')，否则已删除记录仍参与计数 - 如果关联表有复合状态（如 status=1 表示创建，2 表示审核中，3 表示完成），别只写
where('status', 1)，确认这是你要的“有效”状态 - 数据库连接配置里的
'stringify_fetches' => false虽不影响 count，但影响后续其他聚合字段类型，建议统一关掉
最常被跳过的其实是外键类型校验和软删除过滤——这两点不出问题时一切正常，一出就是全量数据偏差，而且很难从 SQL 日志里一眼看出原因。
