agentmain方式才是热加载审计日志的关键：它支持运行时attach并注册classfiletransformer，配合retransformclasses可实现已加载类的日志注入，但需确保jvm支持retransformation且目标方法未被jit编译或声明为native/final。
agentmain 方式才是热加载审计日志的关键
premain 只能在 JVM 启动时生效，而业务系统通常不允许重启。真正实现「不重启注入审计日志」必须走 agentmain 路径——它允许在运行中 attach 一个 agent 并注册 ClassFileTransformer，后续新加载或重定义的类都会被拦截。
但要注意：agentmain 本身不能修改已加载类的方法体（除非配合 Instrumentation.retransformClasses()），所以审计日志逻辑要覆盖两类场景：
- 新加载的类：直接在
transform()中插入日志字节码 - 已存在的类：需先调用
retransformClasses()触发二次转换（要求目标类未被 JVM 优化掉，如未被 JIT 编译为 native code）
Byte Buddy 封装了这些细节，但底层仍依赖 JVM 的 retransformation 支持，不是所有 JDK 版本都默认开启——OpenJDK 8u212+、JDK 11+ 默认支持，JDK 8 早期版本需加 -XX:+UnlockDiagnosticVMOptions -XX:+ReinterpretCodeOnDemand（不推荐生产使用）。
用 Byte Buddy 注入日志前，先确认目标方法是否可增强
不是所有方法都能被安全插桩。常见失败点包括：
-
native方法：Byte Buddy 无法重写，transform()中跳过即可，否则抛java.lang.UnsupportedOperationException - 已被 JIT 编译的热点方法：JVM 拒绝 retransform，日志不会出现；可用
-XX:+PrintCompilation观察，或临时加-XX:-TieredStopAtLevel=1降级编译层级 - final 类或方法：Byte Buddy 默认不处理，需显式启用
disableClassFormatChanges()或改用Advice（更轻量，不重写类结构） - 构造器或 lambda 生成的合成方法：需用
ElementMatchers.isConstructor()或isSynthetic()显式匹配，否则漏掉
建议优先对 Service 层接口方法做增强，避开 Spring CGLIB 代理类（如 *$$EnhancerBySpringCGLIB*），直接匹配原始类名更稳定。
审计日志字段必须和等保三级要求对齐，不能只打个 println
单纯在方法入口加 System.out.println("audit: " + args) 不满足合规要求。真实上报需包含：timestamp、operatorId、src_ip、bizType、status、errorMsg 等字段，并走异步加密传输通道。
Byte Buddy 插入代码时，应调用你已封装好的审计 SDK（如 AuditLogger.log()），而不是拼字符串。示例片段：
new AgentBuilder.Default()
.type(ElementMatchers.nameContains("Service"))
.transform((builder, typeDescription, classLoader, module) ->
builder.method(ElementMatchers.any())
.intercept(MethodDelegation.to(AuditInterceptor.class)))
AuditInterceptor 内部需从 SecurityContextHolder 提取用户、从 RequestContextHolder 提取 IP，并捕获异常后填充 status 和 errorMsg。注意：ThreadLocal 在异步线程中不可见，若方法内启了新线程，需手动透传上下文。
attach 失败或日志没出现？先查这三个地方
动态注入失败往往卡在基础链路，而非 Byte Buddy 语法：
- JVM 进程是否启用 attach 功能？JDK 9+ 默认关闭，需启动时加
-Djdk.attach.allowAttachSelf=true（本地测试）或确保目标进程有tools.jar（JDK 8）或jdk.attach模块（JDK 9+） - agent JAR 的
META-INF/MANIFEST.MF是否含Agent-Class: com.example.MyAgent（agentmain必须项），且该类有 public static void agentmain(String args, Instrumentation inst) 方法 - 日志输出是否被 SLF4J 绑定到
NOOP？Byte Buddy 自身日志走net.bytebuddy.dynamic.scaffold.TypeWriter，建议加-Dnet.bytebuddy.dump=/tmp/bb-dump查看生成的类字节码是否含预期指令
最易忽略的是：agentmain 注册的 ClassFileTransformer 是全局单例，如果多个 agent 同时注册，后注册的会覆盖前者的 transform()，务必用唯一标识隔离逻辑。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
