数据库抛出java.sql.SQLException却未进入对应catch块，转而执行Exception块

核心问题：抛出的java.sql.SQLException未被对应catch块捕获，反而进入父类Exception的处理块，本质是原始异常被框架包装成了其他类型的RuntimeException。

具体处理步骤 #

• 排查异常包装层级：在Exception的catch块中打印完整异常栈（e.printStackTrace()），或通过e.getCause()逐层追溯，会发现原生SQLException被嵌套在框架抛出的异常（比如MyBatis的PersistenceException、Spring的DataAccessException）内部，外层异常属于RuntimeException类型，所以会跳过SQLException的catch块，直接进入Exception块。
• 针对性捕获异常：
  1. 优先捕获框架抛出的包装异常，再从中提取原始SQL异常做判断：

     try {
         // 数据库插入操作
     } catch (PersistenceException e) { // 以MyBatis为例
         Throwable rootCause = e.getCause();
         if (rootCause instanceof SQLException) {
             SQLException sqlEx = (SQLException) rootCause;
             // 通过错误码匹配ORA-12899
             if (sqlEx.getErrorCode() == 12899) {
                 // 处理字段过长的业务逻辑
                 System.out.println("字段长度超过数据库列的最大限制");
             }
         }
     } catch (Exception e) {
         // 其他通用异常处理
     }
     

  2. 若无法确定框架包装类型，可在Exception块内递归遍历异常链，查找目标SQL异常：

     private boolean isORA12899Exception(Throwable e) {
         if (e == null) return false;
         if (e instanceof SQLException) {
             SQLException sqlEx = (SQLException) e;
             return sqlEx.getErrorCode() == 12899;
         }
         return isORA12899Exception(e.getCause());
     }
     
     // 在catch块中调用
     try {
         // 数据库插入操作
     } catch (SQLException e) {
         // 理论上原生SQL异常会进入这里，但被包装后不会触发
     } catch (Exception e) {
         if (isORA12899Exception(e)) {
             // 处理字段过长逻辑
         } else {
             // 其他异常处理
         }
     }
     

• 前置校验优化：在插入数据库前，提前校验字段长度（比如判断字符串长度是否超过50），直接拦截错误，比捕获异常更高效。

内容的提问来源于stack exchange，提问作者Vishal Gandotra