spring boot 全局异常处理可以通过配置 @controlleradvice 结合自定义的 handlerexceptionresolver 或拦截器来捕获读写分离异常。核心做法是识别由读写分离框架(如 shardingsphere、mybatis-plus 动态数据源等)抛出的特定异常类型,并在统一异常处理器中进行分类响应。

如何识别并捕获读写分离框架抛出的具体异常类?
读写分离异常通常不是 Spring 原生异常,而是由底层数据源路由逻辑或数据库驱动抛出。例如,ShardingSphere 会抛出 ShardingSphereSQLException,而 MyBatis-Plus 动态数据源可能抛出 DataSourceLookupFailureException 或 IllegalStateException。要捕获这些异常,必须在 @ControllerAdvice 中明确指定这些异常类型,或者通过继承 HandlerExceptionResolver 接口来自定义解析逻辑,从而在异常传播到控制器之前进行拦截。

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
@ControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {
@ExceptionHandler(ShardingSphereSQLException.class)
public ResponseEntity<String> handleShardingException(ShardingSphereSQLException ex) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body("读写分离路由失败: " + ex.getMessage());
}
@ExceptionHandler(IllegalStateException.class)
public ResponseEntity<String> handleDataSourceException(IllegalStateException ex) {
if (ex.getMessage() != null && ex.getMessage().contains("data source")) {
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
.body("数据源切换异常,请检查配置");
}
throw ex;
}
}
如何在异常处理中区分主库与从库故障场景?
区分主从库故障的关键在于分析异常堆栈中的错误码或消息内容。例如,连接超时通常指向网络或从库负载过高,而权限拒绝则可能涉及主库配置变更。通过在异常处理器中提取异常信息中的关键字段,可以返回更精确的错误提示,帮助前端或调用方快速定位问题。此外,还可以结合日志记录将详细堆栈信息输出到监控系统,便于后续排查。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
@ControllerAdvice
public class DataSourceAwareExceptionHandler {
private static final Logger log = LoggerFactory.getLogger(DataSourceAwareExceptionHandler.class);
@ExceptionHandler(Exception.class)
public ResponseEntity<String> handleGenericException(Exception ex) {
String message = ex.getMessage();
if (message != null && message.contains("master")) {
log.error("主库访问异常", ex);
return ResponseEntity.status(HttpStatus.BAD_GATEWAY).body("主库不可用");
} else if (message != null && message.contains("slave")) {
log.warn("从库访问异常", ex);
return ResponseEntity.status(HttpStatus.TOO_MANY_REQUESTS).body("从库繁忙,请稍后重试");
}
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("未知数据库错误");
}
}
当读写分离配置失效时,程序默认回退到哪个数据源?
当读写分离配置失效时,程序的行为取决于具体使用的框架实现。以 MyBatis-Plus 动态数据源为例,若所有从库均不可用且未启用自动降级策略,系统通常会抛出异常并终止请求;但若配置了 fallback 机制,则会默认回退到主库执行操作。ShardingSphere 同样支持通过 fallbackStrategy 参数设置降级行为,确保在主从切换失败时仍能维持基本可用性。开发者应在配置文件中显式声明此类策略,以避免意外中断。


















