如何捕获数据库连接中断异常？基于Spring JDBC Template的实现疑问

嘿，这个场景我太熟悉了！用Spring JDBC Template的时候，光抓通用异常确实没法精准处理数据库宕机的情况，下面给你捋清楚怎么实现：

一、先搞懂Spring JDBC的异常转换逻辑 #

Spring会把原生JDBC的SQLException转换成自己的**DataAccessException体系**下的子类，这样我们不用硬编码适配不同数据库的底层异常。数据库宕机这类连接失败的场景，通常对应两种核心异常：

• CannotGetJdbcConnectionException：Spring封装的顶层异常，当无法从连接池获取数据库连接时抛出（比如数据库宕机、网络中断）
• SQLTransientConnectionException：JDBC 4.0+的标准异常，属于短暂性连接故障，大部分数据库驱动（比如MySQL、PostgreSQL）在数据库宕机时都会抛出它的子类（比如MySQL的CommunicationsException）

二、服务层精准捕获异常的实现 #

你可以在服务层方法里直接捕获这些特定异常，替代原来的通用异常捕获。下面给你写个完整的示例：

DAO层（基于JdbcTemplate） #

@Repository
public class UserDao {
    @Autowired
    private JdbcTemplate jdbcTemplate;

    // 查询用户
    public User getUserById(Long id) {
        String sql = "SELECT id, name, email FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, 
            (rs, rowNum) -> new User(rs.getLong("id"), rs.getString("name"), rs.getString("email")));
    }

    // 保存用户
    public void saveUser(User user) {
        String sql = "INSERT INTO users(name, email) VALUES(?, ?)";
        jdbcTemplate.update(sql, user.getName(), user.getEmail());
    }
}

服务层（添加异常捕获逻辑） #

@Service
public class UserService {
    private static final Logger log = LoggerFactory.getLogger(UserService.class);
    
    @Autowired
    private UserDao userDao;

    public User getUser(Long id) {
        try {
            return userDao.getUserById(id);
        } catch (CannotGetJdbcConnectionException e) {
            // 数据库宕机专属处理逻辑：记录告警、返回友好提示、触发降级等
            log.error("数据库连接失败，疑似数据库宕机", e);
            throw new ServiceException("系统暂时无法访问，请稍后再试"); // 自定义业务异常
        } catch (DataAccessException e) {
            // 处理其他数据库操作异常（比如SQL语法错误、主键冲突）
            log.error("数据库查询失败", e);
            throw new ServiceException("数据查询失败");
        }
    }

    public void createUser(User user) {
        try {
            userDao.saveUser(user);
        } catch (CannotGetJdbcConnectionException | SQLTransientConnectionException e) {
            // 兼容Spring封装异常和JDBC标准异常，覆盖更多场景
            log.error("数据库连接异常，可能数据库已宕机", e);
            // 可选：降级逻辑，比如把数据暂存到本地文件/MQ，等数据库恢复后重试
            throw new ServiceException("当前无法保存数据，请稍后重试");
        } catch (DataAccessException e) {
            log.error("保存用户失败", e);
            throw new ServiceException("保存用户失败");
        }
    }
}

三、额外优化建议 #

• 全局异常处理：如果不想在每个服务方法里重复写捕获逻辑，可以用Spring的@RestControllerAdvice做全局拦截，统一处理CannotGetJdbcConnectionException这类异常，返回标准化的响应格式。
• 区分连接池耗尽和宕机：CannotGetJdbcConnectionException也可能是连接池耗尽导致的，你可以通过e.getRootCause()查看根源异常，比如MySQL的CommunicationsException就明确是数据库通信失败，也就是宕机了。
• 重试机制：可以结合Spring Retry组件，针对数据库连接异常做自动重试，但要注意控制重试次数和间隔，避免加重系统负担。

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