ORA-00001 是 Oracle 数据库因违反唯一约束（如唯一索引或主键）而抛出的固定格式错误码，表示尝试插入或更新重复值；其格式恒为“ORA-”后接5位数字，不受框架封装影响，应通过异常消息字符串精确提取。
直接提取 ORA-00001 错误码，别依赖异常类型名
java 的 sqlexception 和其子类（如 sqlintegrityconstraintviolationexception）在不同驱动版本、不同框架封装下可能被包装多层，光靠 instanceof 判断容易漏判。真正稳定的方式是从异常消息里抠出原始 oracle 错误码。
关键点在于：Oracle 错误信息固定以 ORA- 开头，后跟 5 位数字（如 ORA-00001），这个格式不会变，也不受 Spring/Hibernate 包装影响。
- 用
String.indexOf("ORA-")定位起始位置，再取后续 5 位字符，比正则更轻量、更可靠 - 注意大小写：日志或某些中间件可能把消息转成大写，所以统一用
toUpperCase()再搜 - 避免直接调
e.getSQLState()—— 它返回的是 SQL 标准状态码（如23000），不区分 ORA-00001 还是 ORA-02291
在 Spring + MyBatis 或 Hibernate 场景下做前置拦截
如果你用的是 MyBatis，异常通常抛在 SqlSessionTemplate 执行阶段；Hibernate 则常被包装为 ConstraintViolationException 或 DataIntegrityViolationException。它们都继承自 DataAccessException，但底层根因仍是 Oracle 报的 ORA-00001。
推荐在 Service 层或统一异常处理器中处理，而不是在 DAO 层硬编码 try-catch：
- 捕获最外层的
RuntimeException或DataAccessException，再用上一节的方法提取错误码 - 不要只 catch
SQLIntegrityConstraintViolationException—— 在 WebLogic 或某些连接池配置下，它可能被二次包装成BatchUpdateException - 如果用 Spring 的
@ExceptionHandler，建议按Exception.class拦截，再做getOraCode(e)分支判断
拿到 ORA-00001 后，怎么映射到具体业务字段？
错误信息里带的约束名（如 DEVSALEP_DATA.SYS_C0012321）是系统生成的，没法直接告诉用户“车架号重复”。必须反查数据库元数据，把约束名映射回业务字段。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
执行这条 SQL 就能拿到字段名和所属表：
SELECT cols.column_name, cons.table_name FROM all_constraints cons JOIN all_cons_columns cols ON cons.constraint_name = cols.constraint_name AND cons.owner = cols.owner WHERE cons.constraint_name = 'SYS_C0012321' AND cons.owner = 'DEVSALEP_DATA';
- 注意：
all_constraints查的是当前用户有权限访问的所有约束；如果是开发环境，用user_constraints更快 - 约束名中的
SYS_C*是 Oracle 自动命名的，说明建表时没显式指定名称，后续维护成本高 —— 建议 DBA 统一规范命名，比如UK_SALES_SEGMENT_NAME - 拿到字段名后，可拼出友好提示：“【销售分段名称】已存在，请勿重复添加”
序列值落后导致主键冲突，Java 层怎么兜底？
ORA-00001 不一定是业务逻辑错，很可能是 DBA 导入数据后没重置序列，比如表里最大 SEGMENT_ID 是 1005，但序列 SEQ_SEGMENT 当前值还是 100，下次 NEXTVAL 就又插 101，必然冲突。
Java 层不能修序列，但可以提前预防：
- 插入前用
SELECT SEQ_SEGMENT.CURRVAL FROM DUAL查当前值（需确保会话已调过NEXTVAL） - 更稳妥的做法：在插入失败且捕获到 ORA-00001 后，主动查一次
SELECT MAX(SEGMENT_ID) FROM TB_SALES_ADM_SEGMENT，再对比序列值，记录告警日志供 DBA 处理 - 避免在应用层重试
NEXTVAL—— 如果序列真卡住了，反复取也解决不了，反而加重问题
真正要命的不是报错本身，而是错误发生后没人知道约束名对应哪张表哪个字段，或者以为改了 Java 就能绕过 —— 数据库约束是最后一道防线，绕不过，只能对齐。
