为何PersistenceExceptionTranslationInterceptor仅关注RuntimeException？SQLException转换建议

一、为什么PersistenceExceptionTranslationInterceptor只关注RuntimeException？ #

这是Spring框架的刻意设计，而非疏忽，核心逻辑源于Spring的DAO层异常体系理念：

• Spring倡导用**非检查型异常（RuntimeException）**简化开发，避免代码被大量强制try-catch块充斥，提升可读性与开发效率。
• PersistenceExceptionTranslationInterceptor的定位是配合Spring的ORM/DAO抽象组件（如JpaTemplate、HibernateTemplate、JdbcTemplate）工作——这些模板类已经将底层的检查型SQLException（包括PostgreSQL的PSQLException）统一转换为Spring自身的DataAccessException（RuntimeException子类）。
• 因此，Interceptor只需处理ORM框架抛出的持久化相关运行时异常，无需重复处理已被模板类转换过的检查型异常。

二、将SQLException转换为自定义异常的方案 #

根据你是否使用Spring的JDBC/ORM模板类，可选择以下方案：

1. 基于Spring JdbcTemplate的转换（推荐） #

若已使用JdbcTemplate，它会自动将SQLException包装为DataAccessException的子类（如BadSqlGrammarException、DuplicateKeyException）。只需捕获这些异常再转换为自定义异常：

@Service
public class UserService {
    private final JdbcTemplate jdbcTemplate;

    public UserService(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    public void createUser(String username) {
        try {
            jdbcTemplate.update("INSERT INTO users(username) VALUES (?)", username);
        } catch (DataAccessException e) {
            Throwable rootCause = e.getRootCause();
            if (rootCause instanceof SQLException) {
                throw new CustomDbException("创建用户失败: " + ((SQLException) rootCause).getMessage(), (SQLException) rootCause);
            }
            throw new CustomDbException("数据库操作失败", e);
        }
    }
}

2. 直接使用JDBC时的统一转换（AOP切面） #

若直接通过JDBC连接操作数据库（未用Spring模板类），可通过Spring AOP实现全局SQLException捕获与转换，避免重复编写try-catch：

@Aspect
@Component
public class SQLExceptionTranslatorAspect {
    // 拦截DAO层所有方法
    @Around("execution(* com.example.dao.*.*(..))")
    public Object translate(ProceedingJoinPoint joinPoint) throws Throwable {
        try {
            return joinPoint.proceed();
        } catch (PSQLException | SQLException e) {
            // 可根据异常类型或错误码做细粒度转换
            throw new CustomDbException("DAO操作异常: " + e.getMessage(), e);
        }
    }
}

3. 自定义方法拦截器 #

若需要更灵活的控制，可自定义MethodInterceptor手动捕获并转换异常：

public class CustomSQLExceptionInterceptor implements MethodInterceptor {
    @Override
    public Object invoke(MethodInvocation invocation) throws Throwable {
        try {
            return invocation.proceed();
        } catch (SQLException e) {
            throw new CustomDbException("数据库操作失败", e);
        }
    }
}

随后在Spring配置中为DAO层Bean注册该拦截器即可。

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