Laravel的hasManyThrough关联是否适用于用户团队职位分配场景？

问题根源：用错了关联类型 #

你当前使用的hasManyThrough并不适用于这个场景，这个关联是为层级关联设计的（比如「国家 -> 用户 -> 文章」这种A通过B关联C的层级关系）。而你的Team和User是多对多关系，中间通过placements表存储关联的时段信息，所以应该用belongsToMany来定义基础关联。

修正模型关联 #

1. Team模型（关联用户） #

class Team extends Model
{
    use HasFactory;

    // 基础多对多关联：团队-用户，携带中间表的时段和职位字段
    public function members()
    {
        return $this->belongsToMany(User::class, 'placements', 'team_id', 'user_id')
            ->withPivot('start', 'end', 'position_id');
    }
}

2. User模型（关联团队和职位） #

class User extends Model
{
    use HasFactory;

    // 用户的所有分配记录
    public function placements()
    {
        return $this->hasMany(Placement::class);
    }

    // 基础多对多关联：用户-团队
    public function teams()
    {
        return $this->belongsToMany(Team::class, 'placements', 'user_id', 'team_id')
            ->withPivot('start', 'end', 'position_id');
    }

    // 基础多对多关联：用户-职位
    public function positions()
    {
        return $this->belongsToMany(Position::class, 'placements', 'user_id', 'position_id')
            ->withPivot('start', 'end', 'team_id');
    }
}

3. Position模型（关联用户） #

class Position extends Model
{
    use HasFactory;

    public function users()
    {
        return $this->belongsToMany(User::class, 'placements', 'position_id', 'user_id')
            ->withPivot('start', 'end', 'team_id');
    }
}

实现你需要的动态查询方法 #

接下来实现currentPosition、position($date)、currentMembers、members($date)这些方法：

1. User模型中的职位查询 #

// 获取用户当前职位
public function currentPosition()
{
    return $this->positions()
        ->where('placements.start', '<=', now())
        ->where(function ($query) {
            // 处理未结束的分配（end为null）或仍在有效期内的情况
            $query->where('placements.end', '>=', now())
                  ->orWhereNull('placements.end');
        })
        ->first(); // 同一时间仅一条分配记录，用first()返回单个结果
}

// 获取用户指定日期的职位
public function position($date)
{
    $targetDate = \Carbon\Carbon::parse($date);
    return $this->positions()
        ->where('placements.start', '<=', $targetDate)
        ->where(function ($query) use ($targetDate) {
            $query->where('placements.end', '>=', $targetDate)
                  ->orWhereNull('placements.end');
        })
        ->first();
}

2. Team模型中的成员查询 #

// 获取团队当前成员
public function currentMembers()
{
    return $this->members()
        ->where('placements.start', '<=', now())
        ->where(function ($query) {
            $query->where('placements.end', '>=', now())
                  ->orWhereNull('placements.end');
        })
        ->get();
}

// 获取团队指定日期的成员
public function members($date)
{
    $targetDate = \Carbon\Carbon::parse($date);
    return $this->members()
        ->where('placements.start', '<=', $targetDate)
        ->where(function ($query) use ($targetDate) {
            $query->where('placements.end', '>=', $targetDate)
                  ->orWhereNull('placements.end');
        })
        ->get();
}

额外优化：使用本地作用域复用逻辑 #

如果需要多处复用日期筛选逻辑，可以把时间条件封装成本地作用域：

在Placement模型中添加：

class Placement extends Model
{
    use HasFactory;

    // 筛选指定日期有效的分配记录
    public function scopeValidOn($query, $date = null)
    {
        $date = $date ? \Carbon\Carbon::parse($date) : now();
        return $query->where('start', '<=', $date)
            ->where(function ($q) use ($date) {
                $q->where('end', '>=', $date)->orWhereNull('end');
            });
    }
}

之后User模型的方法可以简化为：

public function currentPosition()
{
    return $this->positions()
        ->whereHas('placements', fn($query) => $query->validOn())
        ->first();
}

public function position($date)
{
    return $this->positions()
        ->whereHas('placements', fn($query) => $query->validOn($date))
        ->first();
}

Team模型的方法同理简化：

public function currentMembers()
{
    return $this->members()
        ->whereHas('placements', fn($query) => $query->validOn())
        ->get();
}

public function members($date)
{
    return $this->members()
        ->whereHas('placements', fn($query) => $query->validOn($date))
        ->get();
}

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