Laravel Eloquent：如何定义活动与同组用户的关联关系？

我有三个模型：Group、Activity、User，模型间关联如下：

• Activity 属于 Group（activity表含group_id字段）
• User 属于 Group（user表含group_id字段）
• Group 拥有多个 Activity 和多个 User

用户和活动仅关联一个群组。我想获取某个活动对应的同组用户列表，尝试使用hasManyThrough关联时，Eloquent报错提示group表不存在activity_id字段。请问该如何定义Activity与同组User的关联关系？

模型结构 #

Group
  name:string

Activity
  name: string
  group_id: int

User
  name: string
  group_id: int

现有模型代码 #

class Group extends Model
{
    public function activities(): HasMany
    {
        return $this->hasMany(Activity::class);
    }

    public function users(): HasMany
    {
        return $this->hasMany(User::class);
    }
}

class User extends Model
{
    public function group(): BelongsTo
    {
        return $this->belongsTo(Group::class);
    }
}

class Activity extends Model
{
    public function group(): BelongsTo
    {
        return $this->belongsTo(Group::class);
    }

    public function users(): HasManyThrough
    {
        return $this->hasManyThrough(User::class, Group::class);
    }
}

解决方案 #

你使用hasManyThrough报错的原因是，Eloquent默认的外键匹配规则和你的表结构不匹配。hasManyThrough的默认逻辑是要求中间模型（Group）包含源模型（Activity）的外键（activity_id），但你的Group表并没有这个字段，实际是Activity表存储了Group的外键group_id。

要正确定义这个关联，需要手动指定hasManyThrough的四个参数，明确外键对应关系：

class Activity extends Model
{
    public function group(): BelongsTo
    {
        return $this->belongsTo(Group::class);
    }

    public function users(): HasManyThrough
    {
        // 参数依次为：目标模型、中间模型、源模型到中间模型的外键、中间模型到目标模型的外键
        return $this->hasManyThrough(
            User::class,
            Group::class,
            'id',          // Group表主键，对应Activity的group_id
            'group_id',    // User表外键，关联Group的id
            'group_id',    // Activity表外键，关联Group的id
            'id'           // Group表主键
        );
    }
}

另外，你也可以通过Activity关联的Group间接获取同组用户，写法更直观：

// 使用时通过group关联调用users
$activity = Activity::find($id);
$sameGroupUsers = $activity->group->users;

两种方式都能实现需求：如果需要直接通过$activity->users获取用户列表，就用第一种手动指定外键的hasManyThrough关联；如果不需要直接定义关联，第二种方式更简洁。

内容的提问来源于stack exchange，提问作者cyles