Laravel中BelongsTo反向一对多关联如何实现关联字段值的求和统计
Laravel 实现物资关联持有量求和的规范方案
前置准备:定义模型关联
按照Laravel的开发约定,先搭好两张表对应的模型和关联关系,避免重复手写join逻辑:
- 定义物资模型
Stuff,对应stuffs表// app/Models/Stuff.php namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\HasMany; class Stuff extends Model { // 业务表无自动时间戳字段,关闭Eloquent默认的时间戳维护 public $timestamps = false; // 定义和用户物资持有表的一对多关联 public function userStuffs(): HasMany { return $this->hasMany(UserStuff::class, 'stuff_id', 'id'); } } - 定义用户物资持有模型
UserStuff,对应user_stuffs表// app/Models/UserStuff.php namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\BelongsTo; class UserStuff extends Model { public $timestamps = false; protected $fillable = ['stuff_id', 'user_id', 'volume']; public function stuff(): BelongsTo { return $this->belongsTo(Stuff::class, 'stuff_id', 'id'); } }
两种合规实现方式
方式1:Eloquent 关联聚合(官方推荐)
直接使用Eloquent内置的withSum方法实现,框架会自动帮你处理关联查询、聚合计算、分组逻辑,最终生成的查询和你写的原生SQL逻辑完全等价,还兼容严格SQL模式要求:
// 控制器业务逻辑 public function getStuffVolumeTotal() { $result = Stuff::query() ->select(['id', 'title']) // 仅取业务需要的字段,减少查询开销 ->withSum('userStuffs as total', 'volume') // 自动求和关联表的volume字段,结果别名为total ->get() ->toArray(); return response()->json($result); }
这种写法默认使用左关联查询,不会遗漏没有任何用户持有的物资记录,对应total值自动返回0,比你之前写的inner join原生SQL更贴合实际业务需求。
方式2:查询构造器显式关联(和原生SQL1:1对齐)
如果你需要完全复刻之前的inner join逻辑,直接使用查询构造器拼接查询即可,不需要写裸原生SQL字符串,方便后续做语法检查和SQL绑定:
use Illuminate\Support\Facades\DB; public function getStuffVolumeTotal() { $result = DB::table('user_stuffs') ->selectRaw('stuffs.id, stuffs.title, SUM(user_stuffs.volume) as total') ->join('stuffs', 'user_stuffs.stuff_id', '=', 'stuffs.id') ->groupBy('user_stuffs.stuff_id') ->get(); return response()->json($result); }
开发注意点
- Laravel默认开启严格SQL分组模式,上面的写法都自动匹配分组规则,不会触发
ONLY_FULL_GROUP_BY的报错 - 如果需要筛选特定条件的物资(比如过滤下架的物资),直接在查询链式调用里加
where条件即可,不需要改聚合逻辑 - 最终返回的字段结构和你要求的
{"title": "物资标题", "total": 总数量}完全一致,不需要额外做字段映射转换
内容的提问来源于stack exchange,提问作者Andreas Hunter
相关产品推荐
相关产品推荐

