Java 21 动态加载代理警告的解决方法

问题描述

在升级 Java 17 到 Java 21 后，运行 JUnit 测试时可能会遇到以下警告信息：

text

WARNING: A Java agent has been loaded dynamically (...\byte-buddy-agent-1.14.9.jar)
WARNING: If a serviceability tool is in use, please run with -XX:+EnableDynamicAgentLoading to hide this warning
WARNING: If a serviceability tool is not in use, please run with -Djdk.instrument.traceUsage for more information
WARNING: Dynamic loading of agents will be disallowed by default in a future release

这些警告源于 Java 21 中的 JEP 451 新特性限制。默认情况下，动态加载 Java 代理将在未来被禁止，现有解决方法多为临时方案，本文介绍根因分析和最佳实践解法。

核心问题

动态加载代理的方式在新的 Java 机制下引发安全警告，需要通过规范方式加载相关组件（如 Mockito/ByteBuddy 等测试工具）

解决方案

📦 构建工具配置方案（首选）

Maven 项目配置

添加依赖插件获取路径信息

xml

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>${maven-dependency-plugin.version}</version>
  <executions>
    <execution>
      <goals>
        <goal>properties</goal>
      </goals>
    </execution>
  </executions>
</plugin>

配置 Surefire 插件显式加载代理

xml

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>${maven-surefire-plugin.version}</version>
  <configuration>
    <!-- 显式加载代理 -->
    <argLine>-javaagent:${org.mockito:mockito-core:jar}</argLine>
    
    <!-- 可选：关闭类共享确保稳定 -->
    <!-- <argLine>-Xshare:off</argLine> -->
  </configuration>
</plugin>

Gradle 项目配置

使用专用插件（推荐）

kotlin

plugins {
    id("com.ryandens.javaagent-test") version "0.8.0"
}

dependencies {
    testJavaagent("net.bytebuddy:byte-buddy-agent:1.15.11")
}

常规配置方案

groovy

test {
    // 临时解决方案（不推荐）
    jvmArgs("-XX:+EnableDynamicAgentLoading") 
}

注意

临时方案仅抑制警告，但不符合 JEP 451 长期规范

🛠 IDE 环境解决方案

IntelliJ 配置

修改运行模板
- 导航：Run > Edit Configurations...
- 选择 JUnit > 点击 Edit configuration templates...
- 在 VM options 中追加：
```
-javaagent:$MAVEN_REPOSITORY$/org/mockito/mockito-core/5.14.2/mockito-core-5.14.2.jar
```
单次运行时配置
- 测试方法旁点击运行按钮
- 选择 Modify Run Configuration
- 在 VM options 添加代理路径

Eclipse 配置

修改 JUnit 配置
- 导航：Run > Run Configurations...
- 选择测试的 JUnit 配置
- 在 Arguments > VM arguments 添加：
```
-javaagent:${env_var:userprofile}\.m2\repository\org\mockito\mockito-core\5.14.2\mockito-core-5.14.2.jar
```

⚠ 临时解决方案（不推荐）

xml

<!-- Maven 临时方案 -->
<configuration>
  <argLine>-XX:+EnableDynamicAgentLoading</argLine>
</configuration>

<!-- 环境变量方式（全局生效） -->
# Linux/Mac (.bashrc/.zshrc)
export JDK_JAVA_OPTIONS="-XX:+EnableDynamicAgentLoading"

# Windows 环境变量
变量: JDK_JAVA_OPTIONS 
值: -XX:+EnableDynamicAgentLoading

重大隐患

这些方案 仅隐藏警告并不解决问题，未来 Java 版本(JDK 22+)中可能完全失效

原理解析

为什么出现警告？

JEP 451 规范：Java 21 默认禁止动态加载代理
动态加载场景：Mockito/ByteBuddy 等测试框架在初始化时需要注入代码
错误提示：byte-buddy-agent-*.jar 表明 ByteBuddy 被动态加载

规范解法优势

总结

方案类型	推荐度	长期有效性	复杂度
构建工具显式加载	⭐⭐⭐⭐	✅	中
IDE 路径配置	⭐⭐	✅	高
开启动态加载	⭐	❌	低

最佳实践建议：

优先通过构建工具配置 -javaagent 加载代理
在 IDE 中尽量通过构建工具执行测试
避免全局开启 EnableDynamicAgentLoading
及时跟进 Mockito/Gradle 团队的兼容方案进展

技术声明：解决方案基于 Mockito 5.x+ 和 JDK 21+ 环境验证，不同版本路径需相应调整

相关文章

Java 21 动态加载代理警告的解决方法 ​

问题描述 ​

解决方案 ​

📦 构建工具配置方案（首选） ​

Maven 项目配置 ​

Gradle 项目配置 ​

🛠 IDE 环境解决方案 ​

IntelliJ 配置 ​

Eclipse 配置 ​

⚠ 临时解决方案（不推荐） ​

原理解析 ​

为什么出现警告？ ​

规范解法优势 ​

总结 ​