Laravel 10中HasManyThrough关联3张表失效问题排查

错误原因 #

你误用了HasManyThrough关联——这个关联适用于一对多的多层级关联场景（比如「用户→文章→评论」），但用户与任务属于多对多关联，中间表为task_users，应当使用belongsToMany关联，而非HasManyThrough。

正确关联写法 #

1. User模型中定义多对多关联 #

替换原有的tasks方法：

use Illuminate\Database\Eloquent\Relations\BelongsToMany;

public function tasks(): BelongsToMany
{
    return $this->belongsToMany(Task::class, 'task_users', 'user_id', 'task_id');
}

参数说明：

• 第一个参数：关联的目标模型Task::class
• 第二个参数：中间表名称task_users
• 第三个参数：中间表中关联当前User模型的外键user_id
• 第四个参数：中间表中关联目标Task模型的外键task_id

2. （可选）Task模型中定义反向关联 #

若需要从任务端关联参与用户，在Task模型中添加：

use Illuminate\Database\Eloquent\Relations\BelongsToMany;

public function users(): BelongsToMany
{
    return $this->belongsToMany(User::class, 'task_users', 'task_id', 'user_id');
}

3. （可选）任务创建者的独立关联 #

如果需要区分「任务创建者」和「参与任务的用户」，在Task模型中单独定义创建者关联：

use Illuminate\Database\Eloquent\Relations\BelongsTo;

public function creator(): BelongsTo
{
    return $this->belongsTo(User::class, 'creator_id');
}

此后可通过$task->creator获取创建者，通过$task->users获取所有参与用户。

验证查询 #

现在执行你的查询代码（建议用findOrFail替代自定义getById，更符合Laravel规范）：

$this->profileUser = User::findOrFail($this->userId)->with('tasks')->first();

此时生成的SQL会正确关联中间表，不会再出现task_user_id字段不存在的错误。

（可选）TaskUser中间表模型设置 #

如果需要对中间表进行额外操作（比如读取关联时间），可以创建TaskUser模型：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class TaskUser extends Model
{
    protected $table = 'task_users';
    public $timestamps = false; // 你的表仅含created_at，无需默认的updated_at

    public function user()
    {
        return $this->belongsTo(User::class);
    }

    public function task()
    {
        return $this->belongsTo(Task::class);
    }
}

若仅需基础多对多关联，无需单独创建中间表模型，Laravel会自动处理关联逻辑。

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