MySQL 自定义唯一键冲突错误提示方法

本文详解如何通过 PDO 异常捕获机制，优雅处理 MySQL 唯一键（UNIQUE）冲突，将生硬的 SQLSTATE 错误（如 1062）转换为用户友好的中文提示，并确保成功插入与重复拒绝两种状态均能正确反馈。

在使用 PDO 向 MySQL 插入数据时，若字段（如手机号 telephone）设置了 UNIQUE 约束，重复值会触发 PDOException，错误码为 23000（SQLSTATE: Integrity constraint violation），默认堆栈信息对终端用户完全不友好。你已正确使用 try/catch 捕获异常并定制重复提示，但遇到一个关键逻辑问题：else 分支未执行，并非代码错误，而是设计误解——catch 块仅在异常发生时运行；而插入成功时根本不会进入 catch，因此 else 永远不会被触发。

✅ 正确做法是：将“操作成功”的反馈移出 catch，放在 try 块末尾（即无异常时自然执行），或用状态标志统一控制输出。推荐使用标志位方式，结构清晰、不易出错：

$success = false;

try {
    $stmt = $pdo->prepare("INSERT INTO subscribers (name, telephone, comment) VALUES (?, ?, ?)");
    $stmt->execute([$name, $phone, $comment]);
    $success = true; // 插入成功，设为 true
} catch (PDOException $e) {
    error_log("DB Error: " . $e->getMessage());
    if ($e->getCode() === '23000') {
        echo '该手机号已被注册，请勿重复提交。';
    } else {
        // 其他数据库错误（如连接失败、字段超长等）
        echo '系统繁忙，请稍后重试。';
    }
}

// ✅ 此处判断是否成功执行（即未抛异常）
if ($success) {
    echo '感谢订阅！信息已成功保存。';
}

? 关键注意事项：

• 不要依赖 catch 中的 else 处理成功场景——异常流与正常流必须分离；
• 始终记录原始异常（error_log()）便于排查非重复类错误（如语法错误、权限问题）；
• 对 23000 的判断建议用字符串比较 $e->getCode() === '23000'（PDO 返回字符串），更稳妥；
• 生产环境应避免直接 echo 提示，建议结合 AJAX 返回 JSON 或跳转至结果页，提升用户体验与安全性；
• 前端也应做基础校验（如手机号格式），但后端唯一性校验不可省略——防绕过、保数据一致性。

通过以上重构，你的表单既能精准拦截重复手机号，又能向用户明确传达“已存在”或“添加成功”两种状态，真正实现健壮、友好、专业的错误处理。