sqlintegrityconstraintviolationexception主键冲突是因插入重复主键值所致，常见于手动指定id、自增逻辑错误、并发未控或数据迁移重复；应通过异常信息精准识别、分场景处理（提示用户/转更新/用uuid）、前置校验与唯一索引防御。
SQLIntegrityConstraintViolationException 是 Java 应用中操作数据库时常见的运行时异常，通常由 JDBC 驱动抛出，表示违反了数据库的完整性约束。当它提示“主键冲突”（如 Duplicate entry 'xxx' for key 'PRIMARY'），说明你试图插入一条记录，其主键值已在表中存在。
为什么会触发主键冲突？
常见原因包括：
- 手动指定了主键值（如自增 ID 字段填了已存在的数字）
- 使用了数据库自增主键（AUTO_INCREMENT / SERIAL），但程序逻辑错误地重复插入相同 ID
- 多线程/分布式环境下未做好并发控制，两个请求几乎同时生成并插入相同主键
- 数据迁移或测试时手动插入了重复主键，后续业务代码未做校验直接插入
如何捕获和处理这个异常？
不能靠 try-catch 吞掉异常就完事，要区分场景做合理响应：
- 如果是用户主动提交（如注册账号），捕获后应返回友好提示：“该ID已被占用，请更换”
- 如果是后台任务或幂等写入，可捕获后转为更新操作（
INSERT ... ON DUPLICATE KEY UPDATE或MERGE） - 若用 JPA/Hibernate，可用
@Entity+@Id配合@GeneratedValue(strategy = GenerationType.IDENTITY)让框架自动管理主键，避免手动生成冲突 - 检查 SQLException 的 SQLState 或 getMessage() 中的关键字（如
"Duplicate entry"、"PRIMARY"）来精准识别主键冲突，而非笼统 catch SQLException
怎么提前避免主键冲突？
防御优于补救：
- 对自然主键（如手机号、邮箱）插入前先
SELECT COUNT(*)校验是否存在（注意加事务或唯一索引保证一致性） - 使用 UUID、雪花算法（Snowflake）等分布式安全 ID 生成器替代数据库自增，从源头降低冲突概率
- 在数据库层面建唯一索引（UNIQUE INDEX）——不只是主键，业务关键字段也要约束
- 批量插入时用
INSERT IGNORE（MySQL）或ON CONFLICT DO NOTHING（PostgreSQL）跳过冲突行
调试时怎么看具体哪条约束被违反？
异常信息里往往包含线索：
- MySQL 报错示例：
Duplicate entry '1001' for key 'PRIMARY'→ 主键重复 - PostgreSQL 报错示例：
duplicate key value violates unique constraint "users_pkey"→ 主键约束 - 如果提示
for key 'uk_email'，说明是唯一索引（非主键）冲突，需查对应字段 - 开启 JDBC 日志（如
logger=Slf4JLogger+trace=true）可看到完整执行 SQL 和参数
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
