IntelliJ项目存在多个源码目录时跨目录导入类编译报错如何解决

根因说明 #

手动在IntelliJ中将src/schema标记为源码目录不生效，是因为Gradle项目的源码集、依赖关系默认由Gradle配置托管，手动修改的IntelliJ项目配置会在Gradle同步后被覆盖，且默认自定义源码集没有配置对main源码集的依赖，因此无法识别跨目录的类引用。

1. 永久修复方案（推荐） #

直接修改Gradle配置，声明自定义源码集及依赖关系，同步后IntelliJ会自动识别配置，不会出现配置失效问题：

Groovy语法（build.gradle） #

sourceSets {
    // 声明schema为自定义源码集，指定源码路径
    schema {
        java {
            srcDir 'src/schema/java'
            // 路径可根据实际项目结构调整，如无java子目录直接填'src/schema'即可
        }
    }
}

dependencies {
    // 配置schema源码集依赖main源码集的编译产物
    schemaImplementation sourceSets.main.output
}

Kotlin DSL语法（build.gradle.kts） #

sourceSets {
    create("schema") {
        java.srcDir("src/schema/java")
    }
}

dependencies {
    "schemaImplementation"(sourceSets.main.get().output)
}

配置完成后点击IntelliJ右上角的Gradle同步按钮，等待同步完成后重新构建项目即可消除报错。

2. 临时修复方案 #

如果不想修改Gradle配置，可手动调整IntelliJ模块依赖：

• 打开File > Project Structure > Modules
• 找到当前项目模块，切换到Dependencies标签
• 点击+号选择Module Dependency，选中当前项目的main模块，将依赖范围调整为Compile
• 保存后重新构建项目即可生效
  注意：该方案会在Gradle同步后被重置，仅适合临时调试使用

3. 额外排查项 #

如果配置完成后仍有报错，可尝试以下操作：

• 确认src/schema目录下类的import语句、包路径没有拼写错误
• 清空IntelliJ缓存重启：打开File > Invalidate Caches...，勾选清理文件系统缓存后重启IDE
• 确认构建使用Gradle而非IDEA自带编译器：打开Settings > Build, Execution, Deployment > Build Tools > Gradle，将Build and run using选项改为Gradle

内容的提问来源于stack exchange，提问作者Suganthan Madhavan Pillai