升级ByteBuddy至1.12.22后Tomcat多WAR实例出现重复类定义异常

现象是否为预期行为？ #

这不是预期行为，是ByteBuddy版本升级后引入的兼容性问题。正如你发现的，ByteBuddy将原本随机命名的访问器类改为固定名称java.lang.ClassLoader$ByteBuddyAccessor$V1，直接导致了多WAR部署时的冲突：

• 单个WAR运行时，INJECTION策略会把该访问器类注入到bootstrap类加载器，一次注入成功后不会重复操作；
• 同一Tomcat下的多个WAR拥有独立的类加载器，当第二个WAR启动时，ByteBuddy会再次尝试向bootstrap类加载器注入同名类，而JVM禁止同一个类加载器重复定义类，因此抛出LinkageError。

多WAR场景下是否允许使用ByteBuddy及INJECTION策略？ #

ByteBuddy本身支持多WAR部署，但INJECTION策略在这种场景下会存在冲突风险。因为INJECTION策略的核心是将生成的类注入到父类加载器链（最终到bootstrap类加载器），而多WAR的ByteBuddy实例都会尝试写入同一个全局类，必然引发重复定义问题。

解决方案 #

• 切换类加载策略：改用ClassLoadingStrategy.Default.WRAPPER或CHILD_FIRST策略，这两个策略会将生成的类加载到当前WAR的独立类加载器中，不会污染全局的bootstrap加载器，从根源避免冲突；
• 提前初始化全局访问器：在Tomcat启动阶段（比如通过全局扩展类）提前初始化ByteBuddy的访问器类，后续WAR启动时ByteBuddy检测到类已存在，就不会重复注入；
• 版本调整：暂时降级到ByteBuddy 1.10.x版本（保留随机类名逻辑），或者关注ByteBuddy后续版本是否针对多部署场景修复该问题后再升级。

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