MySQL 自定义唯一键冲突错误提示方法
本文详解如何通过PDO异常捕获机制，优雅处理MySQL唯一键（UNIQUE）冲突，将生硬的SQLSTATE错误（如1062）转换为用户友好的中文提示，并确保成功插入与重复拒绝两种状态均能正确反馈。
本文详解如何通过 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 或跳转至结果页，提升用户体验与安全性；
- 前端也应做基础校验（如手机号格式），但后端唯一性校验不可省略——防绕过、保数据一致性。
通过以上重构，你的表单既能精准拦截重复手机号，又能向用户明确传达“已存在”或“添加成功”两种状态，真正实现健壮、友好、专业的错误处理。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
