本文详解如何在 laravel eloquent 查询中，通过 addselect() 一次性为每条书籍记录附加全局评分总数（而非各书独立计数），避免 n+1 查询或多次数据库往返，同时规避常见 sql 错误。
本文详解如何在 laravel eloquent 查询中，通过 addselect() 一次性为每条书籍记录附加全局评分总数（而非各书独立计数），避免 n+1 查询或多次数据库往返，同时规避常见 sql 错误。
在 Laravel 开发中，常需同时获取「每本书的评分数量」和「整个评分表的总记录数」。例如：Books::withCount('rating') 可轻松获得每本书的 rating_count，但若想在同一查询结果中为每一行都附带全局总评分数（如 12），直接使用 ->addSelect(['total_books' => Rating::count()]) 会失败——因为 Rating::count() 返回的是 PHP 整数，而 addSelect() 期望的是一个 子查询对象（Builder 实例），而非执行后的数值。这正是报错 Unknown column '105' 的根源：Laravel 尝试将整数 105（假设总记录数）当作列名插入 SQL，导致语法错误。
✅ 正确做法是：传入一个未执行的子查询 Builder 实例，让 Laravel 在最终 SQL 中将其编译为嵌套子查询。以下是推荐的三种实现方式：
✅ 方式一：使用 addSelect() + 子查询（推荐）
$books = Books::query()
->withCount('rating') // 添加 rating_count 字段
->with(['author:id,user_id', 'author.user:id,name,email']) // 预加载关联
->addSelect([
'total_ratings' => Rating::selectRaw('COUNT(*)') // 注意：返回 Builder，非执行结果
])
->get();生成的 SQL 类似：
SELECT `books`.*, (SELECT COUNT(*) FROM `ratings` WHERE `books`.`id` = `ratings`.`book_id`) AS `rating_count`, (SELECT COUNT(*) FROM `ratings`) AS `total_ratings` FROM `books`;
✅ 优点：纯 SQL 实现，高效、原子性强；total_ratings 对每行均相同（如 12），且随数据实时变化。
✅ 方式二：使用 selectRaw() + 预计算值（适合静态/低频变更场景）
$totalRatings = Rating::count(); // 先执行一次，获取整数
$books = Books::query()
->withCount('rating')
->with(['author:id,user_id', 'author.user:id,name,email'])
->selectRaw('*, ? as total_ratings', [$totalRatings])
->get();⚠️ 注意：此方式将 total_ratings 作为常量注入，不参与 SQL 子查询，适用于总数极少变动的场景；若评分表高频写入，需注意数据一致性。
✅ 方式三：保留 whereIn 条件（非必需，仅作兼容演示）
虽然 Rating::whereIn('book_id', Books::select('id')) 在外键约束健全时冗余（因 book_id 必然指向有效书籍），但若需显式限定范围，可这样写：
$books = Books::query()
->withCount('rating')
->with(['author:id,user_id', 'author.user:id,name,email'])
->addSelect([
'total_ratings' => Rating::selectRaw('COUNT(*)')
->whereIn('book_id', Books::select('id'))
])
->get();⚠️ 关键注意事项
- 命名语义化：建议将字段命名为 total_ratings 而非 total_books，因其统计的是 ratings 表总行数，与书籍数量无关；
- 性能考量：方式一的子查询在 MySQL 中通常极快（COUNT(*) 走索引），无需担心性能瓶颈；
- 模型关系验证：确保 Books 模型中 rating() 关系正确声明为 hasMany(Rating::class, 'book_id')，且数据库存在对应外键约束；
- 避免常见错误：切勿在 addSelect() 中传入 Rating::count() 或 DB::table('ratings')->count() 等执行后返回整数的方法——它们无法被 Laravel 解析为合法 SQL 片段。
最终返回的 JSON 数据中，每本书对象将包含 rating_count（本书记分数量）和 total_ratings（全表总评分数）两个字段，结构清晰、语义明确，完美满足单次查询聚合需求。
