Gradle依赖配置问题：引入Selenium后编译失败如何解决？

核心问题分析 #

1. 依赖范围错误：你把Selenium依赖配置为testImplementation，这个配置仅对src/test/java下的测试代码生效，但你的主代码（src/main/java）里引用了Selenium的类，编译主代码时无法找到该依赖，导致报错。
2. 根项目依赖查看方式错误：你的项目是多模块结构（app是子模块），根项目未配置Java相关插件，所以执行gradle dependencies只会显示根项目的空配置，需指定子模块查看依赖。

修复步骤 #

1. 修正Selenium依赖范围 #

修改app/build.gradle中的dependencies块，将Selenium的依赖从testImplementation改为implementation，这样主代码编译和运行时都能访问该依赖：

plugins {
    id 'application'
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation libs.junit.jupiter
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
    // 把testImplementation改成implementation
    implementation 'org.seleniumhq.selenium:selenium-java:4.16.1'
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

application {
    mainClass = 'example.App'
}

tasks.named('test') {
    useJUnitPlatform()
}

2. 正确查看子模块依赖 #

要查看app子模块的依赖配置，执行以下命令：

./gradlew app:dependencies

3. 验证构建 #

执行构建命令确认问题解决：

./gradlew build

补充说明 #

• 依赖范围区别：
  • implementation：主代码、测试代码编译和运行时都可使用的依赖
  • testImplementation：仅测试代码编译和运行时可用的依赖
  • 如果你的主代码只是引用Selenium类但实际运行不需要（比如仅做类型声明），也可以用compileOnly，但一般Selenium在运行时也需要，所以用implementation更合适。

内容的提问来源于stack exchange，提问作者Fully Buzzword Compliant