Spring Boot Gradle项目中IntelliJ仅认可类路径依赖而非Gradle依赖的问题

问题描述 #

开发基于Gradle的Spring Boot Java应用时，IntelliJ IDEA 2024.3.4.1无法正常识别已在build.gradle中声明的spring-boot-starter-test依赖，代码中使用@SpringBootTest、MockMvc等组件时，IDE提示需添加至类路径，但手动添加后可正常生效。已尝试重新克隆项目、清除IDE缓存，问题仍未解决。

项目Gradle配置 #

plugins {
    java
    id("org.springframework.boot") version "3.4.2"
    id("io.spring.dependency-management") version "1.1.7"
}

group = "x"
version = "x"

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

repositories {
    mavenCentral()
}

dependencies {
    // Spring Boot
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("org.springframework.boot:spring-boot-starter-aop")
    implementation("jakarta.servlet:jakarta.servlet-api:6.0.0")

    // Spring Test
    developmentOnly("org.springframework.boot:spring-boot-devtools")
    testImplementation("org.springframework.boot:spring-boot-starter-test") {
        exclude(group = "org.junit.vintage", module = "junit-vintage-engine")
    }
    compileOnly("org.jetbrains:annotations:26.0.2")

    // Database
    runtimeOnly("org.postgresql:postgresql")

    // JWT
    implementation("io.jsonwebtoken:jjwt-api:0.12.6")
    runtimeOnly("io.jsonwebtoken:jjwt-impl:0.12.6")
    runtimeOnly("io.jsonwebtoken:jjwt-jackson:0.12.6")
}

tasks.withType<Test> {
    useJUnitPlatform()
}

解决方案 #

• 检查IDE的Gradle导入设置
  打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle，确保：

  • 「Build and run using」和「Run tests using」均设置为「Gradle」
  • 「Use Gradle from」选择「Gradle wrapper (recommended)」，避免本地Gradle版本不兼容

• 强制重新同步Gradle依赖
  点击右侧Gradle面板的「Refresh all Gradle projects」图标，或在终端执行命令：

  # Linux/macOS
  ./gradlew clean build --refresh-dependencies
  # Windows
  gradlew.bat clean build --refresh-dependencies
  

• 验证模块测试依赖范围
  打开File → Project Structure → Modules → 目标模块 → Dependencies，确认spring-boot-starter-test处于「Test」依赖范围，若缺失则点击「+」→「Library」添加对应依赖到Test范围

• 核对Java版本一致性
  确认IDE的Project SDK、Module SDK与Gradle配置的Java 23一致：

  • 打开File → Project Structure → Project，设置Project SDK为Java 23，Language level为23
  • 切换到Modules标签，确保每个模块的SDK和Language level也为23

• 重置IDE项目配置文件
  关闭IDE，删除项目根目录下的.idea文件夹和所有.iml文件，重新打开项目让IDE重新导入Gradle配置

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