spring boot 全局异常处理无法直接捕获副本同步异常,因为副本同步通常发生在数据库驱动或连接池层面,属于底层 i/o 阻塞或网络超时,而非 java 应用层的业务逻辑异常。要捕获这类问题,必须通过配置数据源(如 hikaricp)的超时参数,并配合自定义的 datasource 拦截器或 aop 切面来监控执行耗时和错误状态,从而将底层的 sqlexception 或 sockettimeoutexception 转化为 spring mvc 可处理的统一异常响应。

如何区分同步延迟与连接断开异常
在 MySQL 主从架构中,副本同步异常主要表现为两种情况:一是写入主库后读取从库时因同步延迟导致的数据不一致;二是网络中断导致的连接断开。前者通常不会抛出异常,而是返回旧数据;后者则会抛出 CommunicationsException 或 SocketTimeoutException。全局异常处理器只能捕获后者,对于前者需要应用层逻辑判断。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import javax.sql.DataSource;
public class DataSourceConfig {
public DataSource dataSource() {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://master:3306/db");
config.setUsername("user");
config.setPassword("pass");
// 设置连接超时,触发异常以便全局捕获
config.setConnectionTimeout(3000);
config.setIdleTimeout(60000);
return new HikariDataSource(config);
}
}
如何通过 AOP 增强异常捕获范围
由于 @RestControllerAdvice 仅能捕获 Controller 层抛出的异常,而数据库操作发生在 Service 层,因此需要在 Service 层使用 AOP 进行环绕通知。当检测到 SQLException 时,手动将其包装为自定义的业务异常,这样全局异常处理器就能统一拦截并返回 JSON 格式的错误信息,而不是默认的白页。

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;
@Aspect
@Component
public class ExceptionHandlerAspect {
@Around("execution(* com.example.service.*.*(..))")
public Object handleServiceExceptions(ProceedingJoinPoint joinPoint) throws Throwable {
try {
return joinPoint.proceed();
} catch (Exception e) {
if (e instanceof java.sql.SQLException) {
throw new SyncException("Database sync error", e);
}
throw e;
}
}
}
如何处理主从切换期间的瞬时故障
在主从切换期间,数据库可能会短暂不可用或路由到错误的节点。此时应用程序会收到 Can't read from server 或 Unknown master 错误。除了上述的 AOP 包装外,还需要在重试机制中排除这些特定错误码,避免无限重试导致雪崩。建议在配置中启用自动重连,并在代码中记录具体的 SQL 错误码以进行差异化处理。











