如何处理用户注册时的Integrity constraint violation:1062重复条目错误？

这个问题很常见——你现在看到的致命错误，是因为PDO默认没有开启异常捕获模式，当触发唯一约束冲突时，直接抛出了未被处理的异常，导致页面显示一堆技术栈信息。咱们可以通过异常捕获+错误码判断来改成用户友好的提示，具体操作如下：

第一步：确保PDO连接开启异常模式 #

首先，在你初始化PDO数据库连接的时候，一定要设置错误模式为ERRMODE_EXCEPTION，这样SQL执行出错时才会抛出PDOException，方便我们捕获处理：

$dsn = 'mysql:host=localhost;dbname=your_database;charset=utf8mb4';
$dbUser = 'your_username';
$dbPass = 'your_password';

try {
    $pdo = new PDO($dsn, $dbUser, $dbPass);
    // 关键配置：开启异常模式
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch(PDOException $e) {
    die("数据库连接失败，请稍后重试");
}

第二步：用try-catch包裹注册插入逻辑 #

把你的用户插入代码放在try块里，然后在catch块中判断错误类型，给出对应提示：

// 获取表单提交的数据（记得先做过滤验证！）
$email = filter_var($_POST['email'], FILTER_VALIDATE_EMAIL);
$userId = $_POST['user_id'];
$password = password_hash($_POST['password'], PASSWORD_DEFAULT);

try {
    // 准备插入语句
    $stmt = $pdo->prepare("INSERT INTO users (email, id, password) VALUES (:email, :id, :password)");
    $stmt->execute([
        ':email' => $email,
        ':id' => $userId,
        ':password' => $password
    ]);

    // 插入成功后的逻辑，比如跳转登录页或提示成功
    echo "<div class='success'>注册成功！即将跳转到登录页...</div>";
    // header("Location: login.php"); // 可以用跳转替代echo
} catch(PDOException $e) {
    // 判断是否是唯一约束重复错误
    // SQLSTATE[23000]是完整性约束违反的通用码，1062是MySQL的重复键具体错误
    if ($e->getCode() === '23000' && str_contains($e->getMessage(), '1062')) {
        // 进一步区分是邮箱还是ID重复
        if (str_contains($e->getMessage(), 'email')) {
            echo "<div class='error'>抱歉，该邮箱已被注册，请更换其他邮箱！</div>";
        } elseif (str_contains($e->getMessage(), 'id')) {
            echo "<div class='error'>抱歉，该ID已被使用，请选择其他ID！</div>";
        } else {
            echo "<div class='error'>该数据已存在，请检查你的输入！</div>";
        }
    } else {
        // 其他数据库错误，生产环境建议只显示通用提示，错误信息写入日志
        // error_log("注册错误详情: " . $e->getMessage()); // 记录日志
        echo "<div class='error'>注册失败，请稍后重试！</div>";
    }
}

额外提示 #

• 一定要先对用户输入做过滤验证（比如用filter_var验证邮箱格式），避免无效数据提交到数据库。
• 生产环境中，绝对不要把数据库的原始错误信息显示给用户，应该把错误详情写入服务器日志，只给用户显示友好的通用提示，防止泄露数据库结构信息。

内容的提问来源于stack exchange，提问作者najma sulaiman