IntelliJ运行TestNG注解报NoClassDefFoundError如何解决

TestNG初学者在IntelliJ编辑器中创建简单Java项目、添加TestNG依赖后运行程序抛出异常，查阅论坛同类问题的过往解决方案均未生效，异常信息如下：

Exception in thread "main" java.lang.NoClassDefFoundError: com/beust/jcommander/ParameterException
    at com.intellij.rt.testng.RemoteTestNGStarter.main(RemoteTestNGStarter.java:105)
Caused by: java.lang.ClassNotFoundException: com.beust.jcommander.ParameterException
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:606)
    at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:168)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:522)
    ... 1 more  

报错核心是TestNG的必需传递依赖缺失：报错中提到的com.beust.jcommander.ParameterException属于JCommander类库，是TestNG运行时必须加载的依赖，出现ClassNotFoundException就说明这个依赖包没有被正确加入项目的运行类路径，常见诱因包括手动导入TestNG单jar包时未同步导入关联依赖、构建工具依赖拉取不完整/缓存损坏、依赖作用域配置错误。

根据你项目使用的依赖管理方式选择对应操作：

• 手动导入jar包的场景
  下载和当前TestNG版本匹配的JCommander jar包，将它和TestNG的jar包一同添加到项目依赖库中，重启IntelliJ后重新运行测试即可。
• Maven管理依赖的场景
  1. 检查pom.xml中的TestNG依赖配置，确认没有手动排除JCommander的传递依赖，可参考标准配置：

     <dependency>
         <groupId>org.testng</groupId>
         <artifactId>testng</artifactId>
         <version>7.5</version> <!-- 可替换为你需要的稳定版本 -->
         <scope>test</scope>
     </dependency>
     

  2. 右键点击项目中的pom.xml，依次选择Maven -> Reload Project，等待依赖重新拉取完成。
  3. 若重新加载后仍报错，删除本地Maven仓库下org/testng和com/beust/jcommander目录中的缓存文件，再重新执行依赖拉取。
• Gradle管理依赖的场景
  1. 检查build.gradle中的TestNG依赖配置，确认配置正确：

     testImplementation 'org.testng:testng:7.5'
     

  2. 点击Gradle侧边栏的刷新按钮重新同步依赖，若存在缓存损坏问题，清理本地Gradle缓存中对应包的目录后重新同步即可。
• 通用校验步骤
  依赖配置完成后，打开File -> Project Structure -> Modules -> Dependencies，确认依赖列表中存在JCommander包，没有标红缺失、作用域配置错误的问题。

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