INSERT重复错误排查：如何定位重复记录及触发重复的列名？

问题1：如何判断数据表中哪条记录存在重复（基于username+email的组合）？ #

要找出基于username+email组合重复的记录，最直接的方式是用GROUP BY分组，配合HAVING子句筛选出出现次数大于1的组合：

SELECT username, email, COUNT(*) AS duplicate_count
FROM `table`
GROUP BY username, email
HAVING COUNT(*) > 1;

这个查询会返回所有重复的username+email组合，以及它们重复的次数。如果需要查看这些重复组合对应的完整记录，可以用子查询关联原表：

SELECT t.*
FROM `table` t
JOIN (
    SELECT username, email
    FROM `table`
    GROUP BY username, email
    HAVING COUNT(*) > 1
) duplicates ON t.username = duplicates.username AND t.email = duplicates.email
ORDER BY t.username, t.email;

这样就能拿到所有重复组合对应的具体记录了。

问题2：INSERT触发唯一键重复错误时，如何获取导致重复的列名？ #

当MySQL抛出1062错误（唯一键冲突）时，PDO的errorInfo[2]会包含详细的错误描述，比如：Duplicate entry 'Superman' for key 'username'或者Duplicate entry 'xxx@xx.com' for key 'email'。我们可以通过解析这个字符串来提取出冲突的列名（或者唯一键的名称）。

修改你的PDO代码，加入错误消息解析逻辑：

try { 
    $pdo->query("INSERT INTO `table`(`username`,`email`) VALUES('Superman','xxx@xx.com')"); 
} catch (PDOException $e) { 
    if ($e->errorInfo[0] == '23000' && $e->errorInfo[1] == '1062') {
        // 解析错误消息，提取冲突的键名
        $errorMsg = $e->errorInfo[2];
        preg_match("/for key '(.+)'/", $errorMsg, $matches);
        if (!empty($matches[1])) {
            $conflictedKey = $matches[1];
            // 如果你的唯一键名称和列名一致（比如单独给username设的唯一键叫username）
            $message = match($conflictedKey) {
                'username' => '用户名已存在',
                'email' => '邮箱已存在',
                default => '该记录已存在'
            };
            throw new CustomException($message);
        } else {
            // 解析失败时的默认提示
            throw new CustomException('该记录已存在');
        }
    }
}

注意点： #

• 如果你的唯一键是复合键（比如同时包含username和email的唯一键），错误消息里会显示键的名称（比如username_email_unique），这时候你需要提前知道键名对应的含义，再返回对应的提示。
• 不同版本的MySQL错误消息格式可能略有差异，正则表达式可能需要根据实际情况微调，但大部分情况下这个正则都能匹配到键名。

内容的提问来源于stack exchange，提问作者Théo SALA