如何在IntelliJ中运行自定义Jolokia？启动报错求助

问题原因 #

你在IntelliJ的运行配置里，将-javaagent参数指向了编译后的类目录（target/classes），但JVM的javaagent机制要求必须传入JAR文件，类目录不符合格式要求，因此抛出"Error opening zip file or JAR manifest missing"错误。而编译后生成的JAR文件包含了正确的Manifest信息，所以直接运行JAR可以正常工作。

修复步骤 #

1. 检查并修改运行配置
   • 打开IntelliJ的「Run/Debug Configurations」，找到你的应用配置项
   • 查看「VM options」中的-javaagent参数，确认是否指向了target/classes目录
2. 替换为JAR文件路径
   • 若已编译好自定义Jolokia的JAR，将参数改为指向生成的JAR文件，示例：

     -javaagent:C:\Users\Desktop\jolokia-1.7.2\jolokia-1.7.2\agent\jvm\target\jolokia-jvm-1.7.2-custom.jar
     

   • 若未生成JAR，先执行构建工具的打包命令：Maven用mvn package，Gradle用gradle jar
3. 确保JAR包含正确Manifest属性
   • 自定义Jolokia时，必须保证JAR的Manifest中包含Premain-Class或Agent-Class属性。用Maven的话，可在pom.xml中配置maven-jar-plugin：

     <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-jar-plugin</artifactId>
         <configuration>
             <archive>
                 <manifestEntries>
                     <Premain-Class>org.jolokia.jvmagent.JolokiaAgent</Premain-Class>
                     <Agent-Class>org.jolokia.jvmagent.JolokiaAgent</Agent-Class>
                     <Can-Redefine-Classes>true</Can-Redefine-Classes>
                     <Can-Retransform-Classes>true</Can-Retransform-Classes>
                 </manifestEntries>
             </archive>
         </configuration>
     </plugin>
     

4. 重新启动应用
   • 保存配置后，再次运行IntelliJ的应用任务，即可正常加载Jolokia agent

额外调试提示 #

如果需要调试自定义Jolokia代码，可先将agent模块作为依赖引入主应用，或在运行配置中添加agent模块的依赖。但无论哪种方式，-javaagent参数仍需指向合法的JAR文件——可以用mvn install将自定义JAR安装到本地仓库，再引用本地仓库的JAR路径。

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