本文详解如何在 laravel 中实现“同一邮箱可跨平台重复，但同平台内邮箱必须唯一”的自定义 unique 验证逻辑，并配合数据库复合唯一索引保障数据一致性。
本文详解如何在 laravel 中实现“同一邮箱可跨平台重复，但同平台内邮箱必须唯一”的自定义 unique 验证逻辑，并配合数据库复合唯一索引保障数据一致性。
在 Laravel 应用中，当 users 表存在多租户或分平台场景（如 platform 字段取值为 site1/site2/site3）时，简单的 unique:users 规则无法满足业务需求——它会全局禁止重复邮箱，而实际要求是：邮箱仅需在相同 platform 下保持唯一。
✅ 正确做法：使用 Rule::unique() + where() 动态条件
Laravel 提供了链式构建 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'],
];? 原理说明：
Rule::unique('users')生成基础查询SELECT COUNT(*) FROM users WHERE email = ?；调用->where(...)后，最终执行的是SELECT COUNT(*) FROM users WHERE email = ? AND platform = ?，从而精准限定校验范围。
⚠️ 注意事项：
- 确保
request()->platform在验证时已存在且可信（建议先校验platform字段有效性，再用于where条件）； - 若字段名非
platform（如source_platform），请同步替换where('platform', ...)中的列名； - 在表单请求类（Form Request）中使用时，推荐通过
$this->platform访问，而非request()->platform，更符合 Laravel 最佳实践。
?️ 数据库层加固：添加复合唯一索引
PHP 层验证可被绕过（如直接调用 API 或数据库操作），因此必须在数据库层面强制约束。在迁移文件中为 email 和 platform 添加联合唯一索引：
// 在 migration 文件中（如 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']); // ✅ 关键：复合唯一键
});执行迁移后，数据库将拒绝插入 email 与 platform 组合已存在的记录，从根源杜绝脏数据。
? 补充技巧：处理更新场景（可选）
若需在用户资料编辑（如 update 请求）中跳过当前用户自身校验，可结合 ignore() 方法：
Rule::unique('users')
->where(fn ($query) => $query->where('platform', $this->platform))
->ignore($this->user->id), // 排除当前用户 ID✅ 总结
| 层级 | 方案 | 作用 |
|---|---|---|
| 应用层 | Rule::unique('users')->where(...) |
动态校验，提升用户体验与前端友好性 |
| 数据库层 | ->unique(['email', 'platform']) |
强制一致性，防止并发冲突与绕过验证 |
二者缺一不可：前者提供即时反馈，后者保障数据坚不可摧。遵循此方案，即可安全支持多平台共用邮箱的注册逻辑。
