ThinkPHP模型关联统计技巧

ThinkPHP 的 withCount() 方法虽能便捷实现关联表的简单计数，却无法应对分组聚合等复杂统计场景——它不支持 GROUP BY、不能按多条件（如用户+订单状态+时间维度）细分统计，强行混用还会触发 SQL 报错；真正可靠的解法是采用子查询 JOIN（将分组聚合逻辑封装进子查询再关联主表）或直接使用原生 SQL，尤其在涉及日期函数、软删除一致性、跨表跨库或严格 SQL 模式时，后者更可控、易调试；而比技术选型更关键的是统计口径的统一——主表与子查询/关联表的时间范围、软删除判断、时区处理必须严格对齐，否则数据偏差隐匿难查。

模型关联统计不能直接在 withCount() 里做分组，必须用子查询或原生 SQL 拼接；否则查出来的只是总数，不是按关联维度的分组聚合值。

withCount() 只能返回单个计数字段，不支持 GROUP BY

很多人以为 withCount('orders') 能自动按用户分组统计订单数，其实它生成的是带子查询的 SELECT，类似 SELECT *, (SELECT COUNT(*) FROM order WHERE user_id = user.id) AS orders_count。这种写法天然无法嵌入 GROUP BY，也做不到“每个用户按订单状态再分组”这种需求。

• 想统计每个用户各状态的订单数？withCount() 无解，它只认关联名，不认条件或分组
• withCount(['orders' => function ($query) { $query->where('status', 1); }]) 只能加 WHERE，不能加 group() 或 sum()
• 强行在主查询链式调用 group('user_id') 后接 withCount()，会触发 SQL 报错：ERROR 1140，因为聚合和非聚合字段混选且没明确分组语义

用 hasMany + 子查询实现关联表分组统计（推荐模型内方案）

核心思路是：把关联表的分组聚合逻辑封装成子查询，再以 JOIN 方式挂到主表上。这样既保持模型可读性，又绕过 withCount() 的限制。

• 先构建子查询：$sub = OrderModel::field('user_id, status, COUNT(*) as cnt')->group('user_id, status')->buildSql();
• 再 JOIN 主表：UserModel::alias('u')->join([$sub => 'o'], 'u.id = o.user_id', 'LEFT')->field('u.*, o.status, o.cnt')->select();
• 注意：子查询别名要用数组包装 [$sub => 'o']，否则 ThinkPHP 6+ 会忽略
• 如果主表有软删除（delete_time），子查询里也要显式加 whereNull('delete_time')，否则统计口径不一致

Db::query() 写原生 SQL 是最可控的方案

当分组维度涉及日期函数（如按月统计每个用户的下单次数）、多层嵌套或跨库表时，硬套模型链式只会增加调试成本。直接写 SQL 更快、更稳、更容易验证。

• 示例：统计每个用户近 30 天按自然周的下单量
  Db::query("SELECT u.id, u.name, WEEK(o.create_time) AS week_num, COUNT(*) AS cnt FROM think_user u LEFT JOIN think_order o ON u.id = o.user_id AND o.create_time >= DATE_SUB(NOW(), INTERVAL 30 DAY) GROUP BY u.id, u.name, WEEK(o.create_time)")
• MySQL 8.0+ 若开启 sql_mode=STRICT_TRANS_TABLES，记得在 SELECT 中给所有非聚合字段加 ANY_VALUE() 或确保它们都在 GROUP BY 里，否则报错
• PHP 接收结果后，用 foreach 手动归并层级结构比依赖模型自动映射更可靠，尤其当字段名含点号（如 o.status）时，避免属性覆盖

真正容易被忽略的是统计口径一致性——比如主表用 whereTime('create_time', '>=', '-30 days')，子查询却没同步这个条件，或者时区设置让 DATE(create_time) 在 PHP 和 MySQL 里解析出不同日期。这类问题不会报错，但数据偏差很难排查。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《ThinkPHP模型关联统计技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。