IntelliJ构建无主类Jar导入Gradle项目报类找不到问题咨询

你通过IDEA Artifact功能构建无主类依赖Jar的操作不正确，是后续引用报错的核心诱因之一。
选择extract to a target jar模式时，IDEA会把所有选中模块的class文件、关联的第三方依赖全部解压后塞进同一个Jar包，过程中极易出现META-INF配置文件覆盖、包结构错乱、类文件缺失的问题；同时这种构建方式完全脱离Gradle自身的构建生命周期，产出的Jar包结构不符合Gradle的依赖识别规范。

• 依赖路径配置不匹配：你把test.jar放在src/libs/目录下，但build.gradle中fileTree配置的扫描路径libs是相对于build.gradle所在项目根目录的，实际扫描的是项目根目录下的libs文件夹，根本无法读取到src目录下存放的Jar包。哪怕你手动在IDEA界面添加了依赖关联，Gradle同步时也会清理掉不符合配置规则的手动挂载项，最终编译时还是找不到类。
• 产出包结构不规范：用IDEA Artifact打出的Fat Jar本身存在结构风险，可能出现包名与实际类路径不匹配、重复类覆盖、字节码文件损坏的问题，就算路径配置正确也可能无法正常识别内部类。
• 重复配置引发冲突：你同时使用了fileTree声明依赖、右键Add as Library、手动在Project Structure添加依赖三种操作，极易出现依赖作用域冲突、重复挂载的问题，直接导致IDEA索引失效。

• 第一步：弃用IDEA Artifact打包方式，使用Gradle原生任务构建标准依赖Jar
  打开原Jar项目的build.gradle文件，添加如下jar任务配置，无需指定主类即可产出标准依赖库：

  jar {
      archiveBaseName.set("test")
      // 如果需要把当前项目依赖的第三方类也打进Jar包，可以放开下面的注释，不需要就保持注释状态
      // from { configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) } }
  }
  

  配置完成后，在IDEA右侧Gradle面板找到对应模块的Tasks -> build -> jar任务，双击执行构建，合规的test.jar会自动生成在原项目的build/libs目录下。
• 第二步：修正目标项目的Jar存放路径与依赖配置
  在目标项目的根目录下新建libs文件夹，把上一步生成的test.jar放入这个文件夹，不要放在src子目录下。之后检查build.gradle中的依赖配置，确保扫描路径和实际存放路径一致：

  dependencies {
      implementation fileTree(dir: 'libs', include: ['*.jar'])
      // 项目原有其他依赖保持不变
  }
  

• 第三步：清理无效配置重建索引
  进入Project Structure的modules依赖配置页，把之前手动添加的test.jar关联全部删除；同时取消之前右键Add as Library生成的关联。之后点击IDEA菜单File -> Invalidate Caches...，勾选清除缓存并重启，等待Gradle同步完成、索引重建结束后，即可正常引用Jar内的类。

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