如何在 Laravel 中安全删除无角色的重复用户记录_技术教程

本文介绍使用 laravel query builder 或 eloquent 实现一键清理：仅删除那些邮箱重复且未分配任何角色（即在 `role_user` 表中无对应记录）的 user 记录，保留每组重复邮箱中至少一个活跃用户（推荐保留最新或最旧的），并避免误删已授权用户。

在 Laravel 应用中，因注册逻辑缺陷或数据迁移问题，常出现同一邮箱对应多个 users 记录，而其中部分用户未被分配任何角色（即 role_user 表中无 user_id 关联）。这类“孤儿用户”不仅占用数据库资源，还可能干扰权限校验与统计分析。本文提供生产环境友好的解决方案——精准定位并删除“既是重复邮箱、又无任何角色”的用户记录，同时规避常见陷阱（如全量误删、未考虑软删除、忽略大小写差异等）。

✅ 正确逻辑解析

目标需同时满足两个条件：

邮箱重复：该邮箱在 users 表中出现 ≥ 2 次；
无角色关联：该用户 id 不在 role_user.user_id 列表中。

⚠️ 注意：原始答案中的子查询 havingRaw('count(*) > 0') 存在逻辑错误（应为 > 1 才表示重复），且未处理邮箱大小写敏感问题（如 John@ExAmple.com 和 john@example.com 应视为重复）。以下为修正后的健壮实现：

✅ 推荐方案：Eloquent + 子查询（支持软删除）

use Illuminate\Support\Facades\DB;
use App\Models\User;

// 删除所有「邮箱重复」且「无角色」的用户（保留每组重复邮箱中 id 最小的记录，即最早创建者）
User::whereNotIn('id', function ($query) {
    // 获取所有有角色的用户 ID
    $query->select('user_id')
          ->from('role_user')
          ->whereNotNull('user_id');
})
->whereIn('email', function ($query) {
    // 获取所有重复邮箱（统一转小写去重）
    $query->select(DB::raw('LOWER(email) as email'))
          ->from('users')
          ->whereNull('deleted_at') // 仅统计有效用户
          ->groupBy(DB::raw('LOWER(email)'))
          ->havingRaw('COUNT(*) > 1');
})
->whereNotIn('id', function ($query) {
    // 保留每组重复邮箱中 id 最小的用户（防止整组被删光）
    $query->select(DB::raw('MIN(id)'))
          ->from('users as u2')
          ->whereColumn('u2.email', 'users.email')
          ->whereNull('u2.deleted_at')
          ->groupBy(DB::raw('LOWER(u2.email)'));
})
->delete();

✅ 替代方案：使用 Query Builder（更可控，适合大表）

若需更高性能或调试方便，可改用原生风格：

DB::table('users')
    ->whereNotIn('id', function ($q) {
        $q->select('user_id')->from('role_user')->whereNotNull('user_id');
    })
    ->whereIn(DB::raw('LOWER(email)'), function ($q) {
        $q->select(DB::raw('LOWER(email)'))
          ->from('users')
          ->whereNull('deleted_at')
          ->groupBy(DB::raw('LOWER(email)'))
          ->havingRaw('COUNT(*) > 1');
    })
    ->whereNotIn('id', function ($q) {
        $q->select(DB::raw('MIN(id)'))
          ->from('users as u2')
          ->whereColumn('u2.email', 'users.email')
          ->whereNull('u2.deleted_at')
          ->groupBy(DB::raw('LOWER(u2.email)'));
    })
    ->delete();

⚠️ 关键注意事项

务必先备份！ 执行前在测试环境验证，并对生产库执行 mysqldump 或使用事务包裹：
```
DB::transaction(function () {
    // 上述 delete() 调用
});
```
软删除兼容性：以上代码默认跳过 deleted_at IS NOT NULL 的记录；若需清理已软删除的重复项，请移除 whereNull('deleted_at') 条件。
邮箱大小写：使用 LOWER(email) 确保 GMAIL.COM 与 gmail.com 被正确识别为重复。

性能优化：为 role_user.user_id 和 users.email 字段添加索引：

ALTER TABLE role_user ADD INDEX idx_user_id (user_id);
ALTER TABLE users ADD INDEX idx_lower_email ((LOWER(email)));

验证结果：执行后建议运行检查语句确认效果：

$dangling = User::whereNotIn('id', function($q) {
    $q->select('user_id')->from('role_user');
})->whereIn('email', function($q) {
    $q->select('email')->from('users')->groupBy('email')->havingRaw('COUNT(*) > 1');
})->get();

通过上述方法，你可在一行核心逻辑中安全、高效地完成数据净化，既符合 Laravel 最佳实践，又兼顾可读性与可维护性。