IntelliJ Kotlin类路径报错：同包同名类覆盖后编辑器异常求助

• 调整模块依赖顺序，确保本地源码优先级高于内部库

  1. 打开 File → Project Structure → Modules，选中当前模块
  2. 切换到 Dependencies 标签页
  3. 将目标内部库依赖（如com.****.logistics.gpltconfig:entities-java:1.0.4-RELEASE）拖拽到当前模块的Sources节点之后，让编辑器优先识别本地源码中的类

• 配置Kotlin编译参数强制优先本地类
  若使用Gradle，在build.gradle.kts中添加：

  kotlin {
      sourceSets.main {
          kotlin.srcDirs("src/main/kotlin")
      }
      compilerOptions {
          freeCompilerArgs.add("-Xskip-metadata-version-check")
      }
  }
  

  若使用Maven，在pom.xml的Kotlin插件中添加参数：

  <plugin>
      <groupId>org.jetbrains.kotlin</groupId>
      <artifactId>kotlin-maven-plugin</artifactId>
      <version>${kotlin.version}</version>
      <configuration>
          <args>
              <arg>-Xskip-metadata-version-check</arg>
          </args>
      </configuration>
  </plugin>
  

• 清除IntelliJ缓存并重启
  操作路径：File → Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart，解决缓存导致的类识别异常

• 标记本地源码目录为Sources Root并同步项目
  右键点击Kotlin源码目录（如src/main/kotlin），选择Mark Directory as → Sources Root，再点击右上角的Gradle/Maven同步按钮，确保编辑器正确识别本地源码

• 排除库中的冲突类
  在IntelliJ中找到内部库中的com.****.raptor.gen.models.TextualEntry类，右键选择Add to Excluded Files，让编辑器忽略库中的该类，仅识别本地同名类

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