最可靠方式是直接捕获pdoexception并判断$e->getcode() === '23000',需开启pdo异常模式、区分mysql错误码(如1062/1452)、事务中手动回滚,且成功逻辑须放在try块内而非catch的else中。

直接捕获 PDOException 并判断 $e->getCode() === '23000' 是最可靠的方式,其他方法(如先查后插、INSERT IGNORE)要么有竞态风险,要么掩盖真实错误类型,不适合需要精准反馈的业务场景。
必须开启 PDO 的异常模式
默认情况下 PDO 不抛异常,prepare() 或 execute() 失败只返回 false,根本进不了 catch。必须在连接后立即设置:
$pdo = new PDO($dsn, $user, $pass); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
- 漏掉这行,整个 try/catch 就是摆设
- 不要用
PDO::ERRMODE_WARNING,它只发警告,不中断流程 - 如果用的是 ThinkPHP/Laravel 等框架,确认其数据库配置已启用异常模式(如 TP 的
'debug' => true通常会自动开,但生产环境可能关)
区分 23000 是哪类冲突
SQLSTATE[23000] 是大类,具体子错误靠 MySQL 原生错误码识别,比如:
-
1062:重复条目(主键或唯一索引冲突),对应手机号、邮箱重复 -
1452:外键约束失败,比如插入订单时client_id不存在 -
1022:重复键名(建表时冲突,运行时少见)
仅靠 $e->getCode() === '23000' 不够精准,建议加一层 $e->errorInfo[1] 判断:
if ($e->getCode() === '23000' && $e->errorInfo[1] === 1062) {
echo '该手机号已被注册';
} elseif ($e->getCode() === '23000' && $e->errorInfo[1] === 1452) {
echo '客户信息无效,请先创建客户';
}
事务中冲突必须手动回滚
在事务里执行插入,一旦触发 23000,PDO 只抛异常,**不会自动回滚**。若不显式调用 rollback(),事务会一直挂起,直到脚本结束或超时,可能导致锁表、连接耗尽:
- ThinkPHP 必须写
Db::rollback(),且要catch \Throwable(不能只catch Exception,因为某些 PDO 错误是Error子类) - Laravel 中用
DB::transaction()包裹时,异常未被捕获才会自动回滚;若你手动try/catch了,就得自己DB::rollBack() - 原生 PDO 要调用
$pdo->rollback(),且确保之前调用了$pdo->beginTransaction()
别把成功逻辑塞进 catch 的 else 里
这是高频翻车点:有人写成这样 ——
try { ... } catch (PDOException $e) {
if ($e->getCode() === '23000') {
echo '重复了';
} else {
echo '成功了!'; // ❌ 永远不会执行
}
}
因为没异常时,程序根本不进 catch。正确做法只有两种:
- 在
try块末尾直接写成功逻辑(最简洁) - 用布尔标志位控制,如
$success = false; ... $success = true; ... if ($success) { ... }
后者更适合需要统一输出位置、或 success/fail 都要走同一响应通道(如 JSON 返回)的场景。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











