已导入Selenium JAR包，测试执行时出现ClassNotFoundException求助

已导入Selenium JAR包，但运行TestNG测试时抛出ClassNotFoundException，具体报错堆栈如下：

[RemoteTestNG] detected TestNG version 7.4.0
java.lang.NoClassDefFoundError: org/openqa/selenium/WebDriver
at java.base/java.lang.Class.getDeclaredMethods0(Native Method)
at java.base/java.lang.Class.privateGetDeclaredMethods(Class.java:3402)
at java.base/java.lang.Class.privateGetPublicMethods(Class.java:3427)
at java.base/java.lang.Class.getMethods(Class.java:2019)
at org.testng.internal.XmlMethodSelector.checkMethod(XmlMethodSelector.java:238)
at org.testng.internal.XmlMethodSelector.setXmlClasses(XmlMethodSelector.java:257)
at org.testng.TestRunner.initRunInfo(TestRunner.java:410)
at org.testng.TestRunner.init(TestRunner.java:334)
at org.testng.TestRunner.init(TestRunner.java:292)
at org.testng.TestRunner.(TestRunner.java:223)
at org.testng.remote.support.RemoteTestNG6_12$1.newTestRunner(RemoteTestNG6_12.java:33)
at org.testng.remote.support.RemoteTestNG6_12$DelegatingTestRunnerFactory.newTestRunner(RemoteTestNG6_12.java:66)
at org.testng.ITestRunnerFactory.newTestRunner(ITestRunnerFactory.java:55)
at org.testng.SuiteRunner$ProxyTestRunnerFactory.newTestRunner(SuiteRunner.java:659)
at org.testng.SuiteRunner.init(SuiteRunner.java:173)
at org.testng.SuiteRunner.(SuiteRunner.java:107)
at org.testng.TestNG.createSuiteRunner(TestNG.java:1300)
at org.testng.TestNG.createSuiteRunners(TestNG.java:1276)
at org.testng.TestNG.runSuitesLocally(TestNG.java:1125)
at org.testng.TestNG.runSuites(TestNG.java:1063)
at org.testng.TestNG.run(TestNG.java:1031)
at org.testng.remote.AbstractRemoteTestNG.run(AbstractRemoteTestNG.java:115)
at org.testng.remote.RemoteTestNG.initAndRun(RemoteTestNG.java:251)
at org.testng.remote.RemoteTestNG.main(RemoteTestNG.java:77)
Caused by: java.lang.ClassNotFoundException: org.openqa.selenium.WebDriver
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520)
... 24 more

这个错误的核心是JVM运行时找不到org.openqa.selenium.WebDriver类，说明编译时依赖存在，但运行时依赖未被正确加载。以下是具体排查和解决步骤：

排查与解决步骤 #

1. 确认Selenium JAR包已添加到运行时依赖 #

• Eclipse环境：右键项目 → Build Path → Configure Build Path → 进入Libraries标签，检查Selenium JAR包是否在列表中，无红色叉号。若路径失效，重新添加正确位置的JAR包；再切换到Order and Export标签，勾选Selenium的JAR包，确保TestNG运行时能加载到这些依赖。
• IntelliJ环境：打开Project Structure → Modules → Dependencies，确认Selenium依赖已添加，且Scope设置为Compile或Runtime。

2. 检查版本兼容性 #

TestNG 7.4.0需搭配兼容的Selenium版本，推荐使用Selenium 4.0以上稳定版本，避免使用过旧的Selenium 2.x版本，版本不兼容可能导致类加载失败。

3. 清理缓存并重建项目 #

• Eclipse：Project → Clean → 选择目标项目执行清理，之后重新运行测试。
• IntelliJ：File → Invalidate Caches... → 勾选Invalidate and Restart，重启后重新构建项目。缓存问题常导致依赖加载异常，清理后可解决大部分此类问题。

4. 验证导入的Selenium JAR包完整性 #

确保导入的是完整的selenium-java-x.x.x.jar（包含核心类的完整包），而非单独的模块JAR包，部分模块JAR会缺失WebDriver等核心类。

5. 手动配置TestNG运行依赖 #

若上述步骤无效，手动指定TestNG运行时的依赖：
右键测试类 → Run As → Run Configurations → 切换到Classpath标签 → 选中User Entries → 点击Add External JARs，重新添加Selenium的JAR包，保存配置后再运行测试。

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