应捕获duplicatekeyexception并转化为业务提示，如“手机号已被注册”；推荐service层try-catch或@controlleradvice全局处理，结合索引命名、sql错误码或预检查询定位冲突字段，封装businessexception统一响应，并记录日志与监控。
在 Java 应用（尤其是 Spring Boot + MyBatis 或 JPA 场景）中，当插入数据违反数据库唯一约束（如 UNIQUE 索引或主键冲突）时，底层会抛出类似 DuplicateKeyException 的异常。这类异常属于技术细节，直接透传给前端或用户极不友好。应将其捕获并转化为明确、可读的业务提示（例如：“手机号已被注册”“用户名已存在”）。
识别并捕获 DuplicateKeyException
Spring JDBC 和 MyBatis 都会将数据库唯一键冲突统一包装为 org.springframework.dao.DuplicateKeyException（JPA 中可能是 DataIntegrityViolationException，需进一步判断根因）。关键是在 Service 层或全局异常处理器中捕获它：
- 推荐在
@Service方法内用try-catch显式处理，便于针对不同操作给出差异化提示（如注册 vs 修改邮箱） - 也可用
@ControllerAdvice全局统一拦截，但需结合错误 SQL 状态码或异常消息进一步区分冲突字段 - 注意：不要只依赖异常消息字符串（如
"Duplicate entry 'xxx' for key 'uk_phone'"）做解析——不同数据库（MySQL/PostgreSQL）格式差异大，且易被误匹配
根据冲突字段映射到具体业务含义
单纯知道“重复了”不够，必须定位是哪个字段（如 phone、username、email）触发了唯一约束。可靠做法是：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
提前约定唯一索引命名规范：例如 MySQL 中建索引时显式命名
uk_user_phone、uk_user_email，再从DuplicateKeyException.getRootCause()获取原生 SQLException，调用getSQLState()或getErrorCode()辅助判断（MySQL 错误码 1062 表示重复键） -
结合业务逻辑预检：在 insert 前先查一次（如
userMapper.selectByPhone(phone)），虽多一次查询，但可控性强、提示精准，适合高一致性要求场景 - 避免仅靠异常 message 正则匹配（如
message.contains("phone")），容易因数据库方言或版本升级失效
封装统一的业务异常与响应结构
定义自定义异常（如 BusinessException）和标准响应体（如 Result<t></t>），将技术异常转为可读提示：
- 在 catch 块中 new 一个
BusinessException("手机号已被注册")并抛出，由全局异常处理器统一返回{ "code": 400, "msg": "手机号已被注册", "data": null } - 若使用 MyBatis，可在
Mapper接口方法上加注解@Select("SELECT id FROM user WHERE phone = #{phone}")配合@Options(flushCache = Options.FlushCachePolicy.FALSE)提升预检性能 - 对高频写入场景（如秒杀），可引入 Redis 缓存已注册手机号的布隆过滤器（Bloom Filter）做前置快速拦截，降低 DB 压力
日志记录与监控建议
转化友好提示的同时，不能丢失原始异常上下文：
- 在捕获
DuplicateKeyException后，用log.warn("Unique constraint violation on user.phone={}", phone, e)记录完整堆栈，便于排查是否出现非预期的并发问题或数据脏写 - 对重复提交导致的冲突，可结合幂等 Token 或请求指纹（如 MD5(body+timestamp+salt)）在网关层拦截，从源头减少异常发生频率
- 将“唯一键冲突次数”作为业务监控指标，突增可能意味着前端防重失效或爬虫恶意试探
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
