本文深入探讨了在 Laravel 应用中构建类似 Tinder 的双向匹配（mutual match）关系。针对初始尝试中 `matches` 关系为空的问题，我们分析了其根本原因，即在关系定义中依赖未加载的模型实例。核心解决方案是利用数据库 `JOIN` 操作直接在 Eloquent 关系中识别双向匹配，并提供了优化 `pivot` 表迁移和添加唯一约束的最佳实践，确保数据完整性和关系定义的准确性。
在构建社交应用，特别是像 Tinder 这样需要用户之间“互相喜欢”才能形成匹配的场景时，正确地定义 Eloquent 关系至关重要。本文将详细讲解如何在 Laravel 中实现这一复杂的双向匹配关系，并提供优化方案。
理解初始实现的问题
许多开发者在尝试实现双向匹配时，可能会倾向于在 matches 关系中结合已有的 likesToUsers 和 likesFromUsers 关系。例如，以下是一种常见的错误尝试：
// User Model (Incorrect Implementation)
public function likesToUsers()
{
return $this->belongsToMany(self::class, 'users_users_liked', 'user_id', 'user_liked_id');
}
public function likesFromUsers()
{
return $this->belongsToMany(self::class, 'users_users_liked', 'user_liked_id', 'user_id');
}
public function matches()
{
// 这种方式在 eager loading 时会失败
return $this->likesFromUsers()->whereIn('user_id', $this->likesToUsers->keyBy('id'));
}这种实现方式存在几个关键问题：
- keyBy 与 pluck 的混淆：whereIn 方法期望一个 ID 数组，而 $this->likesToUsers->keyBy('id') 返回的是一个以 ID 为键、模型实例为值的集合。正确的做法应该是使用 pluck('id') 来获取 ID 数组。
- Eager Loading 的限制：最核心的问题在于，在定义 Eloquent 关系时，你不能直接依赖于当前模型实例的已加载关系数据（如 $this->likesToUsers）。当 Laravel 尝试进行预加载（eager loading）时，$this->likesToUsers 尚未被加载，或者在加载多个模型时，它可能只使用了第一个模型的关联值，导致其他模型的匹配关系不准确。关系定义应该基于数据库层面的逻辑，而不是基于已加载的模型状态。
简而言之，尝试在关系定义中直接使用一个已加载关系的“值”来过滤另一个关系，在预加载场景下是不可行的。
正确实现双向匹配关系
要正确实现双向匹配，我们需要利用数据库的 JOIN 操作来直接在数据库层面找出相互喜欢的用户。这可以通过将 pivot 表自身连接两次来实现。
belongsToMany(self::class, 'users_users_liked', 'user_id', 'user_liked_id');
}
/**
* 喜欢当前用户的其他用户
*/
public function likesFromUsers()
{
return $this->belongsToMany(self::class, 'users_users_liked', 'user_liked_id', 'user_id');
}
/**
* 获取与当前用户形成双向匹配的用户
*/
public function matches()
{
return $this->likesFromUsers()
->join('users_users_liked as alt_users_users_liked', function (JoinClause $join) {
$join->on('users_users_liked.user_liked_id', '=', 'alt_users_users_liked.user_id')
->on('users_users_liked.user_id', '=', 'alt_users_users_liked.user_liked_id');
});
}
}解析 matches() 方法：
- $this->likesFromUsers()：这首先构建了一个查询，查找所有喜欢当前用户的用户。它基于 users_users_liked 表（在这里是主表，别名为 users_users_liked）。
- join('users_users_liked as alt_users_users_liked', ...)：我们再次连接 users_users_liked 表，但这次给它一个不同的别名 alt_users_users_liked。
- function (JoinClause $join)：在连接回调中定义连接条件。
- $join->on('users_users_liked.user_liked_id', '=', 'alt_users_users_liked.user_id')：这个条件确保了如果主表中的 user_liked_id（即当前用户）被 alt_users_users_liked 表中的 user_id（即另一个用户）喜欢。
- $join->on('users_users_liked.user_id', '=', 'alt_users_users_liked.user_liked_id')：这个条件则确保了主表中的 user_id（即另一个用户）被 alt_users_users_liked 表中的 user_liked_id（即当前用户）喜欢。
通过这两个 ON 条件，我们有效地筛选出了那些在 users_users_liked 表中存在双向记录的用户，从而实现了双向匹配。
优化 Pivot 表迁移
为了提升代码的简洁性和数据库的健壮性，我们可以优化 users_users_liked 迁移文件。
原始迁移：
Schema::create('users_users_liked', function (Blueprint $table) {
$table->increments('id');
$table->unsignedInteger('user_id')->index();
$table->foreign('user_id')->references('id')->on('users')->onDelete('cascade')->onUpdate('cascade');
$table->unsignedInteger('user_liked_id')->nullable()->index(); // nullable 可能不是最佳实践
$table->foreign('user_liked_id')->references('id')->on('users')->onDelete('cascade')->onUpdate('cascade');
$table->timestamps();
});优化后的迁移：
Laravel 提供了 foreignId() 方法，可以简化外键的定义，并链式调用 constrained() 来自动推断表名和列名。同时，添加唯一约束可以防止用户重复喜欢同一个用户。
id(); // 使用 id() 替代 increments('id')
$table->foreignId('user_id')->constrained()->cascadeOnDelete()->cascadeOnUpdate();
$table->foreignId('user_liked_id')->constrained('users')->cascadeOnDelete()->cascadeOnUpdate();
$table->timestamps();
// 添加唯一约束，防止重复喜欢
$table->unique(['user_id', 'user_liked_id']);
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('users_users_liked');
}
};优化说明：
- $table->id()：这是 increments('id') 的更简洁写法。
- $table->foreignId('user_id')->constrained()->cascadeOnDelete()->cascadeOnUpdate()：foreignId() 会创建一个 UNSIGNED BIGINT 类型的列。constrained() 会自动尝试将 user_id 关联到 users 表的 id 列。cascadeOnDelete() 和 cascadeOnUpdate() 则定义了级联操作。
- $table->foreignId('user_liked_id')->constrained('users')->cascadeOnDelete()->cascadeOnUpdate()：这里明确指定了 constrained('users')，因为列名 user_liked_id 不直接对应 users 表的命名规范，但其含义仍然是引用 users 表。
- $table->unique(['user_id', 'user_liked_id'])：这是一个非常重要的优化，它确保了任何一对用户之间只能存在一条“喜欢”记录，避免了数据冗余和逻辑错误。
总结
通过上述修正和优化，我们成功地在 Laravel 中实现了一个健壮且高效的双向匹配关系。核心在于理解 Eloquent 关系的本质，避免在关系定义中依赖运行时状态，而是利用数据库层面的 JOIN 操作来精确筛选数据。同时，遵循最佳实践来设计和优化 pivot 表，可以进一步提升应用的数据完整性和可维护性。在实际开发中，结合 Model Factories 来填充测试数据，将有助于验证这些关系的正确性。
