这种情况我之前在Kotlin项目里碰到过好几次，明明IDE能正常识别类、跳转定义，甚至没标红报错，但一构建就弹出「Unresolved reference: ApiKey」，真的挺闹心的。结合我的排查经验，给你几个方向试试：

1. 确认模块依赖的正确性 #

首先得确保应用模块真的正确引入了ewn库模块，还要注意构建类型的匹配：

• 检查应用模块的build.gradle.kts（或.gradle）依赖配置，必须是面向主代码的依赖，不能是测试依赖：

dependencies {
    // 用implementation或api引入库模块，不要用testImplementation
    implementation(project(":ewn"))
}

• 同时确认ewn库模块的构建插件配置正确，比如是Android库还是纯Kotlin库：

plugins {
    id("com.android.library") // Android库用这个
    kotlin("android") // 对应Android平台的Kotlin插件
    // 如果是纯Kotlin JVM库，用id("org.jetbrains.kotlin.jvm")
}

2. 清理缓存强制同步 #

IDE缓存和Gradle缓存经常会“不同步”，导致识别和构建不一致，试试这几步：

• 执行IDE的File -> Invalidate Caches...，勾选「Clear file system cache and local history」后重启IDE
• 在终端执行命令强制刷新依赖并重新构建：

  # Mac/Linux
  ./gradlew clean build --refresh-dependencies
  # Windows
  gradlew.bat clean build --refresh-dependencies
  

3. 检查库模块的源码目录结构 #

ApiKey类必须放在库模块的主源码目录里，要是不小心放在测试目录或者非源码目录，IDE能识别但构建会忽略：

• Android库的主源码目录默认是src/main/kotlin/，纯Kotlin库是src/main/kotlin/
• 可以在库模块的build.gradle.kts里确认源码集配置：

sourceSets {
    main {
        kotlin.srcDirs("src/main/kotlin")
    }
}

4. 检查类的访问可见性 #

如果ApiKey类的访问修饰符是internal，那它只能在ewn库模块内部访问，跨模块调用必须改成public（Kotlin顶级类默认是public，除非你显式声明了internal）。要是ApiKey是嵌套类，也要确认外层类的可见性没问题。

5. 深挖Gradle完整报错日志 #

有时候简短的报错信息藏不住细节，你可以把Gradle控制台的完整报错内容贴出来，比如：

Task :app:compileDebugKotlin FAILED
/app/src/main/kotlin/com/example/MyClass.kt:12:5 Unresolved reference: ApiKey

完整日志能帮我们定位是不是某个子任务失败，或者模块构建顺序有问题。

如果以上方法都没用，试试删掉项目根目录和各模块下的.gradle文件夹，再重新同步Gradle——有时候缓存文件损坏会导致这种莫名其妙的问题。

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