本文介绍在 laravel 中通过 eloquent 和 query builder 实现商品列表与对应平均评分、评分总数的一体化查询，涵盖关联聚合、空评分处理及性能优化要点。
本文介绍在 laravel 中通过 eloquent 和 query builder 实现商品列表与对应平均评分、评分总数的一体化查询，涵盖关联聚合、空评分处理及性能优化要点。
在构建电商或内容平台的评价系统时，常需为每个商品动态展示「平均分」和「评价总数」。Laravel 提供了多种优雅方式实现该需求，但直接使用 Product::all() 无法获取关联统计值，必须借助聚合查询与表连接。以下是推荐的三种实践方案，兼顾可读性、健壮性与性能。
✅ 方案一：使用 Eloquent 关系 + withCount() 与 withAvg()（推荐，Laravel 8.73+）
若已正确定义模型关系（Product 与 Review），这是最简洁、语义清晰的方式：
// Product.php 模型中定义关系
public function reviews()
{
return $this->hasMany(Review::class, 'product_id');
}
// Controller 中查询（支持 Laravel ≥8.73）
$products = Product::withCount('reviews')
->withAvg('reviews', 'rating')
->get();
返回结果中每个 $product 对象将自动包含：
- $product->reviews_count（整数，评分数）
- $product->reviews_avg_rating（浮点数，平均分；无评分时为 null）
? 提示：字段别名可通过 as 自定义，如 withAvg('reviews', 'rating as avg_score')。
Laravel 13.2.0下载PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
✅ 方案二：使用 Query Builder 手动 JOIN + 聚合（兼容所有版本）
当模型关系未定义或需高度定制 SQL 时，可使用原生查询构建器：
use Illuminate\Support\Facades\DB;
$products = DB::table('products')
->select(
'products.*',
DB::raw('COUNT(review.id) as reviews_count'),
DB::raw('COALESCE(AVG(review.rating), 0) as avg_rating')
)
->leftJoin('reviews', 'reviews.product_id', '=', 'products.id')
->groupBy('products.id')
->get();
关键细节说明：
- 使用 LEFT JOIN 确保无评价的商品仍被包含；
- GROUP BY products.id 是聚合查询必需项；
- COALESCE(AVG(...), 0) 将 NULL 平均分转为 0，避免前端判空逻辑；
- 显式选择 products.* 防止因 GROUP BY 导致字段丢失（MySQL 严格模式下必需）。
⚠️ 注意事项与最佳实践
- N+1 问题规避：切勿在循环中对每个商品单独查 Review::where('product_id', $id)->count()，会造成严重性能瓶颈；
- 索引优化：确保 reviews.product_id 字段已建立数据库索引（ALTER TABLE reviews ADD INDEX idx_product_id (product_id);）；
- 空值处理：AVG() 在无匹配记录时返回 NULL，建议统一用 COALESCE(..., 0) 或后端逻辑归零；
- 数据类型：avg() 返回 float，若需保留小数位（如 4.67），可在前端 number_format($avg, 2) 或数据库层 ROUND(AVG(...), 2)；
- Eloquent vs Query Builder：优先使用 Eloquent 方案（方案一），它自动映射模型、支持访问器/修改器，并便于后续扩展（如添加软删除过滤）。
综上，推荐以 Eloquent 关系为基础，结合 withCount() 与 withAvg() 实现开箱即用的聚合查询——代码简洁、可维护性强，且完全符合 Laravel 最佳实践。
