Java不支持注解直接控制异常堆栈输出，需结合AOP或字节码增强实现；定义@LogStackTrace注解并用Spring AOP拦截异常，根据注解值决定是否打印完整堆栈，生产环境应统一使用logger.error("msg", e)而非e.printStackTrace()。
Java 本身不提供运行时通过注解直接控制 e.printStackTrace() 或日志输出行为的内置机制——注解是静态元数据，不会自动触发打印逻辑。要实现“用自定义注解控制是否打印堆栈”，必须配合 AOP（如 Spring AOP）或字节码增强（如 AspectJ），在方法执行异常时拦截并根据注解决定行为。
定义自定义注解
声明一个运行时保留、可用于方法的注解：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogStackTrace {
boolean value() default true; // true=打印堆栈，false=不打印（仅记录消息）
}
用 AOP 拦截异常并读取注解
以 Spring AOP 为例，编写切面，在目标方法抛出异常时检查该方法是否有 @LogStackTrace 注解：
- 使用
@AfterThrowing获取异常对象和连接点（JoinPoint） - 从
joinPoint.getSignature().getDeclaringType()和方法名反射获取 Method 对象 - 调用
method.getAnnotation(LogStackTrace.class)判断是否启用堆栈打印 - 若启用，用
logger.error("msg", e)（推荐）或e.printStackTrace()（仅调试） - 若禁用，只记录
logger.error("msg: {}", e.getMessage())，不传异常对象
关键注意事项
注意几个容易出错的点：
立即学习“Java免费学习笔记（深入）”；
- 不能仅靠注解存在就自动打印：注解本身无行为，必须有切面/处理器主动读取并响应
- 避免混用 printStackTrace() 和日志框架：生产环境统一走 logger.error("msg", e)，否则堆栈无法被 ELK/Loki 收集
-
嵌套异常需显式展开：若业务异常包装了底层异常（如
new ServiceException("xxx", cause)），日志框架默认只打外层；需配置%xEx或确保cause被正确传递 - 性能考虑：反射读取注解开销小，但高频方法上建议缓存 Method → Annotation 映射，避免重复反射
替代轻量方案（无 AOP）
如果项目未引入 AOP，也可在 catch 块中手动检查：
try {
doSomething();
} catch (Exception e) {
Method method = YourClass.class.getMethod("doSomething");
LogStackTrace ann = method.getAnnotation(LogStackTrace.class);
if (ann != null && ann.value()) {
logger.error("Operation failed", e); // ✅ 完整堆栈
} else {
logger.error("Operation failed: {}", e.getMessage()); // ❌ 无堆栈
}
}
缺点是侵入性强、不可复用，仅适合少量关键方法。
