
本文详解如何通过 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 或跳转至结果页,提升用户体验与安全性;
- 前端也应做基础校验(如手机号格式),但后端唯一性校验不可省略——防绕过、保数据一致性。
通过以上重构,你的表单既能精准拦截重复手机号,又能向用户明确传达“已存在”或“添加成功”两种状态,真正实现健壮、友好、专业的错误处理。










