ByteBuddy AgentBuilder$Transformer API变更引发AbstractMethodError问题求助

问题核心 #

你遇到的AbstractMethodError本质是ByteBuddy版本不兼容：新版AgentBuilder$Transformer的transform方法多了ProtectionDomain参数，但你依赖的Mockito引入了旧版（1.10.20）ByteBuddy且无法升级，导致Agent代码调用的接口方法签名与运行时加载的旧版接口不匹配。

Shading方案可行建议 #

1. 构建工具配置全量包重命名 #

通过构建工具的Shading插件，将你Agent依赖的新版ByteBuddy包路径完全重命名，与Mockito引入的旧版ByteBuddy彻底隔离。以Maven Shade Plugin为例：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <relocations>
                    <relocation>
                        <pattern>net.bytebuddy</pattern>
                        <!-- 替换成你的自定义包路径 -->
                        <shadedPattern>com.your.agent.shaded.bytebuddy</shadedPattern>
                        <includes>
                            <include>net.bytebuddy.**</include>
                        </includes>
                    </relocation>
                </relocations>
                <!-- 保留ByteBuddy Agent所需的服务配置 -->
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <manifestEntries>
                            <Premain-Class>nz.ac.wgtn.nullannoinference.agent.NullLoggerAgent</Premain-Class>
                            <Can-Redefine-Classes>true</Can-Redefine-Classes>
                        </manifestEntries>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

如果用Gradle，对应使用Shadow Plugin，核心配置也是重命名net.bytebuddy包到自定义路径。

2. 代码依赖与编译适配 #

• 在你的Agent模块中，单独引入新版ByteBuddy依赖（无需设置为provided），确保编译时使用新版API编写Transformer逻辑。
• 编译打包后，插件会自动将代码中所有net.bytebuddy的引用替换为你配置的重命名路径，运行时Agent将加载自己隔离的新版ByteBuddy类，不会与Mockito的旧版本产生冲突。

3. 关键验证点 #

• 打包后解压Agent JAR，检查类路径是否存在你配置的重命名包（比如com.your.agent.shaded.bytebuddy），且原net.bytebuddy路径不存在。
• 运行插桩测试，确认AbstractMethodError不再抛出，同时验证Mockito原有功能正常（确保隔离生效）。

注意事项 #

• 必须全量重命名ByteBuddy包，不能只重命名部分类，否则仍可能出现类加载冲突。
• 若Agent使用了ByteBuddy的扩展功能（比如自定义Matcher、Transformer），也要确保这些类引用的都是重命名后的ByteBuddy类。

内容的提问来源于stack exchange，提问作者jens