本文介绍如何在 laravel 中为用户注册表单添加条件化唯一性验证，确保同一邮箱仅在相同 platform 下不可重复，不同 platform 下可共用同一邮箱，并提供数据库层面的复合唯一索引建议。
本文介绍如何在 laravel 中为用户注册表单添加条件化唯一性验证，确保同一邮箱仅在相同 platform 下不可重复，不同 platform 下可共用同一邮箱，并提供数据库层面的复合唯一索引建议。
在 Laravel 应用中，当 users 表包含多租户或分平台字段（如 platform）时，简单的 unique:users 规则无法满足「邮箱在指定 platform 内唯一」的业务需求。默认的 unique 规则会跨所有平台校验，导致合法的跨平台注册被拒绝；而错误地将 platform 作为第三参数（如 'unique:users,platform,site1'）则会误将 platform 字段当作待校验字段，完全偏离预期逻辑。
正确做法是使用 Laravel 的 Rule::unique() 构建器，并通过 where() 方法动态添加查询条件。假设注册请求中包含 email 和 platform 字段，验证规则应如下编写：
use Illuminate\Validation\Rule;
$rules = [
'email' => [
'required',
'email',
Rule::unique('users')->where(fn ($query) => $query->where('platform', request()->platform)),
],
'platform' => ['required', 'in:site1,site2,site3'],
];该写法会在底层生成类似 SQL 的查询：
SELECT COUNT(*) FROM `users` WHERE `email` = ? AND `platform` = ?
从而精准限定唯一性检查的作用域。
⚠️ 重要注意事项：
-
request()->platform需确保在验证执行时已存在且可信。若platform来自前端不可信输入，建议先在控制器中预校验其合法性（如使用in:site1,site2,site3），再用于where()条件，避免 SQL 注入风险（虽然where()自动参数化，但业务逻辑完整性仍需保障）。 - 若使用表单请求类（Form Request），推荐在
rules()方法中通过$this->platform访问，语义更清晰：Rule::unique('users')->where(fn ($query) => $query->where('platform', $this->platform))
✅ 数据库层加固（强烈推荐）：
仅靠应用层验证不足以防止并发冲突或绕过 API 的直接写入。应在数据库迁移中为 email 和 platform 建立复合唯一索引：
// 在 users 表迁移中（如 create_users_table.php）
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('email');
$table->string('platform'); // e.g., 'site1', 'site2', 'site3'
// ...其他字段
$table->unique(['email', 'platform']); // 关键：复合唯一约束
});执行 php artisan migrate 后，数据库将自动拒绝违反 (email, platform) 组合唯一性的插入操作，形成双重保障。
? 总结：
实现平台级邮箱唯一性验证需两步协同——应用层用 Rule::unique()->where() 精确控制验证逻辑，数据库层用复合唯一索引兜底防护。二者缺一不可：前者提升用户体验与开发可控性，后者保障数据一致性与系统健壮性。
