使用PHP PDO实现唯一随机字母数字数据插入 重复则自动重生成

前提操作：给reg_key字段添加唯一约束 #

首先必须给reg_key字段添加唯一索引，从数据库层面避免重复数据插入，同时为后续的冲突判断提供基础：

ALTER TABLE User ADD UNIQUE INDEX uk_reg_key (reg_key);

原来的先查询再比对再插入的方案存在竞态条件问题：高并发场景下两个请求同时查询到同一个reg_key不存在，会同时发起插入请求，最终导致重复数据入库，除非额外加锁/事务，复杂度更高。

推荐实现：基于唯一冲突重试的插入逻辑 #

直接生成随机串后尝试插入，捕获PDO抛出的唯一约束冲突异常后重试即可，代码更简洁，且天然避免竞态问题：

代码示例 #

<?php
// 生成随机字母数字串的函数，可根据需求调整长度，建议16位以上降低碰撞概率
function generateRandomKey(int $length = 16): string
{
    return substr(bin2hex(random_bytes($length)), 0, $length);
}

$pdo = new PDO('mysql:host=你的主机地址;dbname=你的数据库名;charset=utf8mb4', '数据库用户名', '数据库密码');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// 最大重试次数，避免极端情况下死循环，10次完全足够覆盖所有常规场景
$maxRetries = 10;
$retry = 0;
$insertSuccess = false;
$name = '要插入的用户名'; // 替换为实际业务的用户名字段值

while ($retry < $maxRetries && !$insertSuccess) {
    try {
        $regKey = generateRandomKey();
        $stmt = $pdo->prepare("INSERT INTO User (name, reg_key) VALUES (?, ?)");
        $stmt->execute([$name, $regKey]);
        $insertSuccess = true;
    } catch (PDOException $e) {
        // 判断是否是唯一约束冲突错误，MySQL的错误码1062对应重复条目
        if ($e->errorInfo[1] === 1062) {
            $retry++;
            continue;
        }
        // 其他非冲突错误直接抛出处理
        throw $e;
    }
}

if (!$insertSuccess) {
    // 重试多次仍失败的兜底异常处理
    throw new Exception('注册码生成失败，请稍后重试');
}
?>

方案优势 #

• 避免了先查询的额外IO开销，正常无冲突场景只需要1次数据库请求
• 天然规避竞态条件，不需要额外加锁或事务处理
• 随机串长度足够的情况下（16位及以上），碰撞概率极低，几乎不会触发重试

补充说明 #

如果你坚持要在前端JavaScript生成reg_key，服务端也可以沿用上述逻辑，只需要把generateRandomKey()的调用替换为前端传过来的reg_key值即可，但注意一定要在服务端做格式校验，避免恶意传入非法值。

内容的提问来源于stack exchange，提问作者Sohon Shome