本文详解如何借助 bytebuddy 的 rebase() 机制，在不丢失原始方法逻辑的前提下，为已有类的方法添加运行时前置校验逻辑，并确保能安全调用原方法（super call），适用于插件环境下的无侵入式增强。
本文详解如何借助 bytebuddy 的 rebase() 机制，在不丢失原始方法逻辑的前提下，为已有类的方法添加运行时前置校验逻辑，并确保能安全调用原方法（super call），适用于插件环境下的无侵入式增强。
在 ByteBuddy 中，“重定义（redefine）”与“重基（rebase）”是两个关键但易混淆的概念：
- redefine() 会完全替换目标方法字节码，原始方法逻辑（即 super 行为）将不可访问；
- rebase() 则会保留原方法体，并将其自动重命名为 *$original 形式的桥接方法，从而允许你在拦截逻辑中显式调用它——这正是实现“前置检查 + 条件性委托原逻辑”的核心前提。
✅ 正确方案：使用 rebase() 实现可调用原方法的运行时代理
以下是一个完整、可直接集成到插件中的示例，假设你要增强 com.example.Foo.bar(String, float, Integer) 方法：
import net.bytebuddy.ByteBuddy;
import net.bytebuddy.agent.ByteBuddyAgent;
import net.bytebuddy.dynamic.loading.ClassReloadingStrategy;
import net.bytebuddy.implementation.MethodDelegation;
import net.bytebuddy.implementation.SuperMethodCall;
import net.bytebuddy.matcher.ElementMatchers;
// 1. 安装 Java Agent（需在插件初始化早期调用）
ByteBuddyAgent.install();
// 2. 使用 rebase() 而非 redefine()，保留原方法可调用性
new ByteBuddy()
.rebase(Foo.class) // ← 关键：不是 redefine()
.method(ElementMatchers.named("bar")
.and(ElementMatchers.takesArguments(String.class, float.class, Integer.class)))
.intercept(MethodDelegation.to(BarInterceptor.class))
.make()
.load(Foo.class.getClassLoader(), ClassReloadingStrategy.fromInstalledAgent());
对应拦截器需支持条件调用原方法：
public class BarInterceptor {
@RuntimeType
public static Object intercept(
@SuperCall(callOriginal = true) Callable> zuper, // 自动注入对原方法的可调用引用
@AllArguments Object[] args,
@This Object self) throws Exception {
// ✅ 前置检查逻辑（例如权限/状态校验）
if (!shouldProceed(args)) {
System.out.println("[Proxy] Blocked call to bar() due to pre-check");
return null; // 或抛出异常、返回默认值等
}
System.out.println("[Proxy] Proceeding to original bar()...");
return zuper.call(); // ← 安全调用原始方法体（已由 rebase 自动保存）
}
private static boolean shouldProceed(Object[] args) {
// 示例：检查第一个参数非空
return args.length > 0 && args[0] != null;
}
}
? 关键注解说明：
- @SuperCall(callOriginal = true) 是 rebase() 场景下的黄金注解，它让 ByteBuddy 注入一个 Callable，封装了对重命名后原始方法（如 bar$original）的反射调用，语义上等价于 super.bar(...)，且线程安全、零开销。
- @AllArguments 和 @This 确保你能访问全部上下文，支撑灵活的业务判断。
⚠️ 注意事项与最佳实践
- 加载时机至关重要：rebase() 必须在目标类被首次初始化之前完成（尤其在插件场景中）。由于你控制插件加载顺序，请确保代理逻辑在 Foo 类被任何其他插件或主程序加载前执行（例如在 Plugin#onLoad() 中触发）。
- 避免重复 rebase：同一类多次 rebase() 可能导致方法名冲突（如 bar$original$original）。建议通过 AgentBuilder 做幂等注册，或加锁保障单次生效。
- 不推荐手动 redefine() + SuperMethodCall：虽然 redefine() 也可配合 SuperMethodCall，但它要求目标方法未被内联或优化（JVM 层面不稳定），而 rebase() 是 ByteBuddy 官方推荐的、稳定支持 super 调用的方案。
- 生产环境建议启用 AgentBuilder：对于更复杂的匹配（如按包名、注解筛选）、热更新容错及日志追踪，应迁移到 AgentBuilder 模式：
new AgentBuilder.Default()
.type(named("com.example.Foo"))
.transform((builder, typeDescription, classLoader, module, protectionDomain) ->
builder.method(named("bar").and(takesArguments(String.class, float.class, Integer.class)))
.intercept(MethodDelegation.to(BarInterceptor.class)))
.installOnByteBuddyAgent();
✅ 总结
要实现“运行时方法代理 + 条件性调用原逻辑”，必须放弃 redefine()，改用 rebase() 配合 @SuperCall。该方案不仅语义清晰、线程安全，而且与 JVM 兼容性极佳，是 ByteBuddy 在 AOP、监控、灰度等场景中的标准实践。在多插件共存环境中，只需把控好类加载时序，即可实现零侵入、高可控的方法级行为增强。
