Gradle子项目依赖构建失败求助：编译引用无法解析

这种IDEA能正常解析依赖，但命令行执行./gradlew build就报类找不到的情况我碰到过好几次，大概率是路径配置或者缓存相关的问题，给你几个针对性的排查和解决方向：

• 检查settings.gradle的子项目路径是否正确
  你说已经include了projB和projC，但要注意：如果这两个子项目是在projA目录下，那settings.gradle里的配置必须带上父项目路径，否则Gradle会默认从根目录去找这两个子项目，自然找不到正确的依赖。正确的配置应该是：

  include ':projA:projB', ':projA:projC'
  

  或者分开写也可以：

  include ':projA:projB'
  include ':projA:projC'
  

  之前只写include 'projB'的话，Gradle根本找不到projA下的projB，IDEA可能靠自动识别补全了路径，但命令行构建是严格按照配置来的。

• 修正projC的依赖声明路径
  对应上面的settings配置，projC的build.gradle里的依赖路径必须和settings里的子项目路径完全一致，而且建议用implementation替代已经废弃的compile：

  dependencies {
      implementation project(':projA:projB')
  }
  

  路径错了的话，Gradle就无法正确关联到projB的编译输出，自然会报类找不到的错误。

• 清理缓存，避免缓存干扰
  有时候旧的缓存会导致依赖解析异常，先清理Gradle的构建缓存，再清理IDE的缓存：

  1. 执行命令清理Gradle缓存并重新构建：

     ./gradlew clean build --no-build-cache
     

  2. 在IntelliJ里点击File -> Invalidate Caches...，选择Invalidate and Restart，彻底清除IDE的缓存后再重新尝试构建。

• 确认projB的插件配置是否适合作为依赖库
  确保projB的build.gradle里使用的是适合作为依赖库的插件，比如java-library（相比普通的java插件，它会更规范地导出依赖）：

  plugins {
      id 'java-library'
  }
  

  如果projB用的是application插件（做应用项目用的），虽然也能被依赖，但可能会有额外的配置问题，换成java-library插件会更稳妥。

• 验证构建顺序是否正确
  Gradle理论上会根据依赖关系自动确定构建顺序，但如果有自定义任务可能会打乱这个逻辑。你可以执行./gradlew projects查看所有子项目的结构，确认projC的依赖是否正确关联；再执行./gradlew projC:build --dry-run，看看Gradle计划的任务顺序里是不是先构建projB再构建projC，如果顺序反了或者没包含projB的构建任务，那肯定会报错。

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