如何在Laravel中定义User模型与自身的多对多关联？

你的问题核心是单向的belongsToMany关联无法覆盖双向的联系人关系——当前关联只查询了当前用户作为user_id发起的联系人，没包含以当前用户为contact_id的接收端联系人。以下是两种符合DRY原则的优雅解决方案：

方案一：修改关联查询条件，包含双向匹配 #

直接在contacts关联中添加where闭包，让查询同时匹配当前用户作为发起者或接收者的记录：

public function contacts(): belongsToMany
{
    return $this->belongsToMany(User::class, 'contacts')
        ->withTimestamps()
        ->where(function ($query) {
            // 匹配当前用户发起的联系人（user_id = 当前ID）
            $query->where('contacts.user_id', $this->id)
                  // 匹配以当前用户为接收者的联系人（contact_id = 当前ID）
                  ->orWhere('contacts.contact_id', $this->id);
        })
        // 排除自身，避免查询到自己
        ->where('users.id', '!=', $this->id);
}

方案二：拆分单向关联并合并（推荐） #

定义两个单向关联分别处理发起和接收的联系人，再通过union合并成双向的contacts关联，这种方式更符合Laravel的关联设计规范，也便于单独使用发起/接收联系人的场景：

// 定义当前用户主动发起的联系人关联
public function initiatedContacts(): belongsToMany
{
    return $this->belongsToMany(User::class, 'contacts', 'user_id', 'contact_id')
        ->withTimestamps();
}

// 定义当前用户接收的联系人关联（外键反转）
public function receivedContacts(): belongsToMany
{
    return $this->belongsToMany(User::class, 'contacts', 'contact_id', 'user_id')
        ->withTimestamps();
}

// 合并两个关联，得到双向的联系人列表
public function contacts()
{
    return $this->initiatedContacts()->union($this->receivedContacts());
}

使用时，无论是UserA->contacts还是UserB->contacts，都能正确返回对方，且无需在数据库中存储重复记录，完全符合DRY原则。

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