IntelliJ启动调试报agent library failed to init: instrument错误如何解决

问题原因 #

这个错误本质是调试启动时JVM尝试将kotlinx-coroutines-core-1.4.3.jar作为Java Agent加载，但该包是协程核心依赖包，不属于Java代理包，本身没有携带Premain-Class的manifest配置，因此初始化失败。
问题仅在调试时触发，是因为当前项目的调试专属启动配置中额外添加了指向该包的错误-javaagent参数，正常运行、编译、测试流程不会加载该配置，其他项目也没有对应错误配置，因此均不受影响。

排查解决步骤 #

• 第一步：检查并修正调试启动配置
  1. 打开IDEA顶部菜单栏的「Run」->「Edit Configurations」
  2. 找到你触发调试的对应配置（如JUnit、Spring Boot应用等）
  3. 查看「VM options」输入框的内容，删除所有包含-javaagent且指向kotlinx-coroutines-core.jar的配置
  4. 保存配置后重新尝试调试
• 第二步：修正协程调试配置（如果你有开启协程调试的需求）
  如果你是为了开启Kotlin协程调试功能添加的参数，属于配置指向错误，按以下方式修正：
  1. 在pom.xml中引入协程调试专用依赖，版本和你使用的coroutines-core版本保持一致：

  <dependency>
      <groupId>org.jetbrains.kotlinx</groupId>
      <artifactId>kotlinx-coroutines-debug</artifactId>
      <version>1.4.3</version>
      <scope>test</scope>
  </dependency>
  

  2. 如需要手动指定javaagent参数，指向的路径应为kotlinx-coroutines-debug对应的jar包，而非core包。
• 第三步：检查全局/项目级默认VM参数
  1. 打开「File」->「Settings」（macOS为「IntelliJ IDEA」->「Preferences」）
  2. 依次进入「Build, Execution, Deployment」->「Build Tools」->「Maven」->「Runner」，检查「VM Options」中是否有错误的javaagent配置，如有则删除
  3. 再进入「Build, Execution, Deployment」->「Debugger」，确认没有额外配置指向coroutines-core的代理参数

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