本文详解如何在 Laravel 中为 users 表的 email 字段实现“按 platform 分组”的唯一性校验，即相同邮箱可存在于不同 platform，但不可在同一 platform 下重复，并同步配置数据库级复合唯一索引保障数据一致性。
本文详解如何在 laravel 中为 `users` 表的 `email` 字段实现“按 platform 分组”的唯一性校验，即相同邮箱可存在于不同 platform，但不可在同一 platform 下重复，并同步配置数据库级复合唯一索引保障数据一致性。
在 Laravel 应用中，当用户注册需关联特定平台（如 site1/site2/site3），且要求同一邮箱仅在相同 platform 下不可重复时，标准的 unique:users 规则不再适用——它会跨平台全局校验，导致误拦截；而错误地将 platform 值硬编码进规则（如 unique:users,platform,site1）则完全失去动态性。
✅ 正确做法是使用 Illuminate\Validation\Rule 的 where() 方法，动态添加查询条件：
use Illuminate\Validation\Rule;
$request->validate([
'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` = ?
从而精准限定校验范围仅为当前提交的 platform 值，既安全又灵活。
⚠️ 重要提醒：应用层验证 ≠ 数据库约束
即使验证逻辑完善，若未在数据库层面加锁，仍可能因并发请求导致脏写（race condition）。因此，必须同步添加复合唯一索引：
在迁移文件中（如 create_users_table.php 或新建迁移）添加：
Schema::table('users', function (Blueprint $table) {
$table->unique(['email', 'platform']);
});执行迁移后，数据库将强制保证 (email, platform) 组合的全局唯一性，从根源杜绝冲突。
? 额外建议：
- 若
platform字段允许为空（NULL），注意 MySQL 中NULL != NULL，会导致多个NULL平台下相同邮箱被允许。此时应显式约束platform为NOT NULL； - 在表单中确保
platform字段已提交且可被request()->platform正确读取（推荐使用validated()或显式$request->string('platform')）； - 如需自定义错误消息，可在
resources/lang/en/validation.php中添加：'unique' => 'The :attribute is already taken for this platform.',
通过「应用层动态验证 + 数据库复合唯一索引」双保险，即可稳健支持多平台场景下的邮箱去重逻辑。
