在java异常处理中记录异常上下文,核心做法是在捕获异常时手动收集关键状态信息(如参数值、业务id、线程名),并将这些信息与异常堆栈一起输出到日志框架中。通常通过自定义日志格式或封装日志方法来实现,确保每次抛出异常时都能附带当时的运行环境快照,从而在排查问题时能还原现场。

如何自动提取当前方法的入参作为上下文
要自动获取方法入参,可以使用AOP切面拦截异常抛出点,结合AspectJ的thisJoinPoint对象获取签名和实参。这种方式无需在每个业务代码中手动添加日志语句,能统一规范上下文的采集逻辑,特别适用于微服务或大型单体应用中需要标准化错误报告的场景。

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;
@Aspect
@Component
public class ExceptionContextAspect {
private static final Logger log = LoggerFactory.getLogger(ExceptionContextAspect.class);
@Around("execution(* com.example.service..*(..))")
public Object captureContext(ProceedingJoinPoint joinPoint) throws Throwable {
String methodName = joinPoint.getSignature().getName();
Object[] args = joinPoint.getArgs();
try {
return joinPoint.proceed();
} catch (Exception e) {
// 将方法名和参数数组转为JSON字符串作为上下文
String context = String.format("Method: %s, Args: %s", methodName, Arrays.toString(args));
log.error("Business Error Context: {}", context, e);
throw e; // 重新抛出异常,保持原有流程
}
}
}上述代码定义了一个全局切面,拦截指定包下的所有方法。当发生异常时,它会将方法名和参数列表拼接成字符串,并通过log.error的第三个参数传入异常对象,这样日志中会同时显示自定义的上下文信息和完整的堆栈跟踪。注意,这里使用Arrays.toString()简单序列化参数,生产环境中建议替换为更安全的JSON序列化工具以避免循环引用问题。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何在异步线程中传递主线程的上下文
在异步执行(如CompletableFuture或线程池)中,子线程默认无法访问主线程的局部变量或MDC(Mapped Diagnostic Context)。解决方法是使用InheritableThreadLocal或在提交任务前显式复制上下文数据。对于基于MDC的日志方案,推荐使用MDC.put()在子线程启动前设置,或使用专门的库如logback-access的扩展功能来自动继承上下文。

import org.slf4j.MDC;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
public class AsyncContextExample {
public void processAsync(String requestId) {
// 1. 在主线程设置上下文
MDC.put("requestId", requestId);
MDC.put("userId", "user-123");
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture.runAsync(() -> {
try {
// 2. 在子线程中,MDC默认不可见,需手动传递或配置Inheritable
// 这里演示手动传递的方式
String currentReqId = MDC.get("requestId");
if (currentReqId == null) {
// 如果未配置InheritableThreadLocal,这里可能为空
// 实际项目中常使用 TransmittableThreadLocal 解决此类问题
System.out.println("Context lost in async thread");
} else {
System.out.println("Processing with context: " + currentReqId);
}
} finally {
// 3. 清理上下文,防止内存泄漏
MDC.clear();
}
}, executor);
}
}这段代码展示了在异步场景中上下文丢失的风险及基本处理思路。关键点在于MDC.clear()必须在finally块中执行,因为线程池中的线程会被复用,不清理会导致后续任务污染日志上下文。对于复杂的异步链路,建议引入阿里开源的TransmittableThreadLocal库,它能更好地处理线程池场景下的上下文传递。
当异常发生在过滤器链中时如何记录请求头上下文
在Spring Boot等Web框架中,过滤器(Filter)或拦截器(Interceptor)是记录HTTP请求上下文的最佳位置。可以在过滤器中捕获内部发生的任何异常,并提取HttpServletRequest中的关键信息(如URL、Method、Header、Client IP)附加到日志中。这有助于区分是业务逻辑错误还是网络/网关层面的问题。

















