bytebuddy 默认不抛出自定义异常，增强失败时抛出 runtimeexception；需在 make()、installon() 等处主动捕获并封装为 bytecodeenhanceexception，该异常应继承 runtimeexception 并携带类名、操作类型及原始异常。
ByteBuddy 默认不会主动抛出自定义异常（如 ByteCodeEnhanceException），它在字节码增强失败时通常会抛出底层的 RuntimeException（如 IllegalStateException、IllegalArgumentException 或 RuntimeException 包装的 java.lang.instrument.Unsafe 错误等）。若你希望统一捕获并转换为业务定义的 ByteCodeEnhanceException，需主动封装异常处理逻辑。
明确增强失败的常见触发点
ByteBuddy 的增强操作（如 make()、installOn()、redefine()）可能因以下原因失败：
- 目标类已被 JVM 锁定（如已加载且未启用
-javaagent或未开启Instrumentation支持） - 类存在不兼容的签名（如尝试重写
final方法、修改private字段访问修饰符） - 动态生成的字节码违反 JVM 验证规则（如栈不平衡、非法跳转）
- 使用了不支持的 Java 版本特性（如对 Java 17+ 的密封类做非法修改）
在关键操作处用 try-catch 封装并转换异常
推荐在调用 make()、installOn() 等核心方法时捕获原始异常，并包装为 ByteCodeEnhanceException：
示例：
try {
DynamicType.Unloaded> unloaded = byteBuddy
.subclass(Object.class)
.method(ElementMatchers.named("toString"))
.intercept(FixedValue.value("enhanced"))
.make();
unloaded.load(getClass().getClassLoader(), ClassLoadingStrategy.Default.INJECTION);
} catch (RuntimeException e) {
throw new ByteCodeEnhanceException("ByteBuddy enhancement failed on class: " + targetClass, e);
}
避免静默吞掉异常或依赖默认行为
不要忽略 ByteBuddy 的链式调用中可能抛出的异常。例如：
-
make()失败会直接抛出异常，不返回 null -
installOn(Instrumentation)在 agent 场景下失败时，通常抛出java.lang.instrument.UnmodifiableClassException等，需显式捕获 - 若使用
new AgentBuilder.Default().installOn(instrumentation)，可通过.with(AgentBuilder.Listener)注册监听器，在onError()回调中记录并抛出自定义异常
定义规范的 ByteCodeEnhanceException
建议让该异常继承 RuntimeException，便于非检查异常传播，同时包含关键上下文信息：
public class ByteCodeEnhanceException extends RuntimeException {
private final String className;
private final String operation;
public ByteCodeEnhanceException(String message, String className, String operation, Throwable cause) {
super(message, cause);
this.className = className;
this.operation = operation;
}
// 可选：提供简洁构造器
public ByteCodeEnhanceException(String message, Throwable cause) {
super(message, cause);
this.className = "unknown";
this.operation = "unknown";
}
}
不复杂但容易忽略Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
