IntelliJ IDEA添加providedCompile依赖后本地运行配置失效问题

我之前维护类似项目时也踩过这个坑，刚好能给你一套实用的解决方案！

问题根源 #

你遇到的核心问题是providedCompile这个Gradle配置的特性：它标记的依赖只会在编译阶段和War打包阶段被引入，但本地运行（比如直接启动Spring Boot主类）时，Gradle和IDEA都不会加载这些依赖——因为provided的语义是“部署容器会提供这些依赖”，但本地开发用的是Spring Boot内置的容器，自然就找不到这些类了。

具体解决方案 #

• 修改build.gradle配置
  在你的依赖块里，保留providedCompile用于War打包，同时添加developmentOnly配置来满足本地运行需求：

  plugins {
      id 'org.springframework.boot' version '你的Spring Boot版本'
      id 'war'
      id 'java'
  }
  
  dependencies {
      // 核心业务依赖
      implementation 'org.springframework.boot:spring-boot-starter-web'
      
      // 打包时标记为容器提供，不打入War包
      providedCompile 'org.springframework.boot:spring-boot-starter-tomcat'
      
      // 仅在本地开发运行时生效，不会被打包进War
      developmentOnly 'org.springframework.boot:spring-boot-starter-tomcat'
  }
  
  // 确保bootRun任务能识别developmentOnly依赖
  bootRun.classpath += sourceSets.main.runtimeClasspath + configurations.developmentOnly
  

• 用Gradle的bootRun任务启动本地服务
  在IDEA中，不要直接右键主类选择“Run”，而是切换到Gradle面板（通常在右侧），找到你的项目 → Tasks → application → 双击bootRun来启动。这样Gradle会自动把developmentOnly的依赖加入运行类路径，完美解决找不到依赖的问题。

• 同步IDEA配置（针对2017.3.4版本）
  如果你之前已经手动配置了运行主类的启动项，建议删除后重新通过bootRun生成；如果不想改启动项，也可以在启动项的“Classpath”设置里，手动把providedCompile的依赖加入运行类路径（不过更推荐用bootRun，能保持配置统一，避免后续踩坑）。

额外小贴士 #

• 如果你用的是较新版本的Spring Boot，官方已经推荐用compileOnly代替providedCompile，语义更清晰，但在Gradle 4.5.1里两者效果一致，你可以根据习惯选择。
• 每次修改build.gradle后，记得点击IDEA右上角的“Sync Project with Gradle Files”按钮，确保IDE同步最新的依赖配置。

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