withCount() 对多态关联失效，因其依赖静态关系定义，无法根据 scoreable_type 动态路由到不同表；必须用子查询或条件 JOIN 实现统计。
多态关联不能直接用 withCount() 统计数量，必须改用子查询或原生 JOIN 方式处理——因为 Eloquent 无法在单个 withCount() 调用中动态判断 scoreable_type 并路由到不同表。
为什么 withCount() 对多态关系失效
withCount() 底层依赖预定义的 Eloquent 关系（如 morphTo()），而多态目标表不固定，Eloquent 无法生成正确的 COUNT 子查询。若强行定义一个通用 scoreable 关系并调用 withCount('scoreable')，会报错或返回 0，因为该关系没有对应物理表可查。
- 错误现象：
Call to undefined relationship [scoreable] on model或结果全为 0 - 根本原因：Eloquent 不支持“根据字段值动态切换关联表”的语义，
withCount()只能绑定到静态声明的关系 - 替代方案只有两种：手动写子查询（推荐），或用
DB::table()+ 条件 JOIN（适合复杂聚合）
用子查询统计每种多态类型数量
最清晰、兼容性最强的方式是为每种可能的 scoreable_type 单独写一个子查询，作为 SELECT 字段注入主查询。这样既避免 JOIN 膨胀，又保持 SQL 可读性。
- 假设
user_points表含scoreable_type（如'AppModelsSupplementaryAssessment'）和scoreable_id - 需分别统计属于
SupplementaryAssessment和PointInteractionSystem的积分条目数 - 示例代码：
$results = DB::table('users')
->select(
'users.id',
'users.name',
DB::raw("(SELECT COUNT(*) FROM user_points WHERE scoreable_type = 'App\Models\SupplementaryAssessment' AND scoreable_id = users.id) as supplementary_count"),
DB::raw("(SELECT COUNT(*) FROM user_points WHERE scoreable_type = 'App\Models\PointInteractionSystem' AND scoreable_id = users.id) as interaction_count")
)
->get();
- 优势：无需 JOIN，不产生笛卡尔积；每个子查询独立过滤，语义明确
- 注意点：类名必须用完整命名空间（
App\Models\...），反斜杠要双写；WHERE 中的=比LIKE '%...%'更安全、更快
用 JOIN 实现多态关联的 SUM/AVG 等聚合
当不只是计数，而是要对多态目标表的某个字段（如 points）求和、平均时，必须用 JOIN，但必须严格使用 INNER JOIN + 显式条件，否则会漏数据或引入 NULL 干扰聚合结果。
- 错误写法：
leftJoin('supplementary_assessments', ...)→ 左连接会让无匹配记录的行保留，导致SUM()计算出错 - 正确写法：对每种类型单独
join()，并在on条件中嵌入scoreable_type判断 - 示例（统计用户总积分）：
$totalPoints = DB::table('user_points')
->join('supplementary_assessments', function ($join) {
$join->on('supplementary_assessments.id', '=', 'user_points.scoreable_id')
->where('user_points.scoreable_type', '=', 'App\Models\SupplementaryAssessment');
})
->join('points_interaction_system', function ($join) {
$join->on('points_interaction_system.id', '=', 'user_points.scoreable_id')
->where('user_points.scoreable_type', '=', 'App\Models\PointInteractionSystem');
})
->select(DB::raw('SUM(COALESCE(supplementary_assessments.points, 0) + COALESCE(points_interaction_system.points, 0)) as total'))
->value('total');
- 关键点：两个
join()是互斥的（一行user_points不可能同时匹配两种类型），所以最终结果仍是单行；COALESCE(..., 0)防止某侧为 NULL 导致整行聚合失效 - 性能提示：确保
user_points(scoreable_type, scoreable_id)有联合索引，否则 JOIN 效率极低
聚合结果字段名易被忽略的细节
用 DB::raw() 写的聚合字段，如果不显式 as xxx，Laravel 返回的数组键名是数据库驱动决定的（如 MySQL 可能是 SUM(...) 这种不可读字符串），前端或后续 PHP 处理极易出错。
- 务必为每个
DB::raw()聚合表达式指定别名，例如：DB::raw('COUNT(...) as interaction_count') - 别名中不要用短横线（
-）、空格或点号，只用下划线和字母数字，否则取值时需加花括号或引号 - 如果聚合结果用于 API 响应，建议统一加前缀（如
score_*）避免与原始字段名冲突
