应在抽象类中使用final模板方法executeWithLogging()封装日志逻辑，强制子类执行「记录开始→调用doWork()→记录结束/异常」流程；通过getClass().getSimpleName()获取子类名，System.nanoTime()统计耗时，Map透传上下文；移除@Slf4j改用protected final Logger log = LoggerFactory.getLogger(getClass())避免日志类名错误；模板方法中统一warn/error记录异常并原样抛出，禁用e.getMessage()拼接。
抽象类里怎么塞日志逻辑才不被子类绕过
直接在抽象类的构造方法或初始化块里写 log.info() 没用——子类可能不调用 super()，或者用的是无参构造，日志就丢了。真正可靠的入口是模板方法：把日志作为骨架流程的一部分，强制子类走这个链路。
- 定义一个
executeWithLogging()模板方法，内部完成「记录开始 → 调用抽象方法doWork()→ 记录结束/异常」 - 子类只管实现
doWork()，不能重写executeWithLogging()（加final） - 如果子类已有业务入口方法（比如
process()），别让它直接暴露；统一重定向到executeWithLogging()
日志内容怎么带上下文又不耦合子类细节
抽象类不知道子类具体做什么，但能拿到通用信息：类名、线程名、执行耗时。关键是要避免在抽象类里硬编码子类字段或方法，否则一加新子类就得改抽象类。
- 用
this.getClass().getSimpleName()获取子类名，比写死字符串更安全 - 耗时统计用
System.nanoTime()，别用new Date()（精度低，还创建对象） - 想透传业务参数？加一个
Map<string object> context</string>参数到模板方法，子类调用时自己塞"orderId"、"userId"这类键值，抽象类只负责打日志，不解析 - 别在抽象类里调
logger.debug("user: " + user.getName())——user可能为null，且子类字段名未必叫user
SLF4J + Lombok @Slf4j 一起用会出什么问题
很多团队给抽象类加了 @Slf4j，结果发现日志里输出的类名全是抽象类名（比如 BaseService），不是实际运行的子类名，排查时定位错对象。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- Lombok 的
@Slf4j在编译期生成private static final Logger log = LoggerFactory.getLogger(XXX.class)，而XXX是抽象类本身 - 解决办法：去掉抽象类上的
@Slf4j，改用protected final Logger log字段，在构造方法里赋值LoggerFactory.getLogger(getClass()) - 注意：必须是
final+protected，既保证子类能用，又防止被覆盖 - 如果用了 Logback，还可以配合
%X{traceId}这类 MDC 字段，但 MDC 的put()和clear()必须成对出现在模板方法里，否则脏数据会跨请求泄漏
子类抛异常时日志怎么既清晰又不重复打印
常见错误是子类在 doWork() 里自己 try-catch 打了一次日志，模板方法又 catch 一次再打——同一异常出现两行日志，堆栈还可能被截断。
立即学习“Java免费学习笔记（深入）”；
- 抽象类的模板方法只做「捕获、记录、重新抛出」，不要
log.error("xxx", e)后吞掉异常 - 用
log.warn("task {} failed", taskName, e)，SLF4J 会自动把e的完整堆栈写进日志，不用手动e.printStackTrace() - 如果子类真要处理部分异常（比如重试），那就让它抛自定义业务异常（如
RetryableException），抽象类针对这类异常单独打 warn，其他一律打 error - 别在抽象类里
e.getMessage()拼字符串——空指针、中文乱码、敏感信息泄露全在这儿埋雷
最麻烦的其实是日志级别混用：抽象层该用 info 的地方写了 debug，结果线上关了 debug 日志就看不到关键路径；或者子类静默吞了本该上报的 error。这事没法靠语法约束，得靠 Code Review 时盯住每一处 log.xxx() 的调用点。
