Kotlin: Cannot access built-in declaration 'kotlin.Unit'. How to fix?

Question

在Kotlin项目中遇到“Cannot access built-in declaration 'kotlin.Unit'”错误时，通常是由于编译器或标准库配置问题导致的。此问题常见于多模块项目或使用了自定义编译器插件的情况下。 **原因与解决方法：** 1. **检查Kotlin版本一致性**：确保项目中所有模块使用的Kotlin版本一致。如果不同模块使用了不兼容的Kotlin版本，可能会导致标准库声明冲突。 2. **清理与重建项目**：尝试运行`./gradlew clean build`命令，清除缓存并重新构建项目。这可以解决因缓存问题引起的错误。 3. **验证依赖冲突**：检查`build.gradle`文件中是否存在重复或冲突的Kotlin标准库依赖。移除多余的依赖声明，例如`implementation "org.jetbrains.kotlin:kotlin-stdlib"`。 4. **升级Kotlin插件**：确保IDE（如IntelliJ IDEA）中的Kotlin插件已更新至最新版本，并与项目中的Kotlin版本匹配。 5. **禁用实验性功能**：如果你使用了Kotlin的实验性API（如IR插件），尝试禁用它们或调整相关配置。 若以上方法无效，请提供具体的`build.gradle`配置以进一步分析问题根源。

Answer 1

1. 问题概述

在Kotlin项目中，如果遇到“Cannot access built-in declaration 'kotlin.Unit'”错误，通常是由编译器或标准库配置问题引发的。这种问题在多模块项目或使用了自定义编译器插件的情况下尤为常见。

以下将从原因分析、解决方法以及深入探讨的角度逐步剖析此问题，并提供系统化的解决方案。

常见场景

• 多模块项目中，不同模块使用了不一致的Kotlin版本。
• 依赖冲突导致的标准库重复声明。
• IDE中的Kotlin插件版本与项目版本不匹配。

2. 原因分析

以下是可能导致此问题的具体原因：

1. Kotlin版本不一致：如果项目中不同模块使用了不同的Kotlin版本，可能会导致标准库声明冲突。
2. 缓存问题：Gradle构建过程中可能因缓存未清理而导致错误。
3. 依赖冲突：`build.gradle`文件中可能存在重复或冲突的Kotlin标准库依赖。
4. 插件版本不匹配：IDE中的Kotlin插件版本与项目使用的Kotlin版本不兼容。
5. 实验性API问题：使用了尚未稳定的Kotlin实验性功能（如IR插件）。

3. 解决方案

根据上述原因，以下是推荐的解决方案：

步骤	操作	说明
1	检查Kotlin版本一致性	确保所有模块使用相同的Kotlin版本。
2	清理与重建项目	运行命令./gradlew clean build以清除缓存并重新构建。
3	验证依赖冲突	检查build.gradle文件，移除多余的依赖声明。
4	升级Kotlin插件	确保IDE中的Kotlin插件已更新至最新版本。
5	禁用实验性功能	尝试禁用Kotlin的实验性API或调整相关配置。

若以上方法无效，请提供具体的build.gradle配置以便进一步分析。

4. 深入探讨

对于更复杂的项目结构，可以结合以下工具和方法进行排查：

        // 示例：检查依赖树
        ./gradlew :module-name:dependencies
    

通过依赖树分析，可以快速定位是否存在重复或冲突的依赖项。

流程图

graph TD;
            A[开始] --> B{检查Kotlin版本};
            B -->|一致| C[清理与重建项目];
            B -->|不一致| D[统一Kotlin版本];
            C --> E{依赖冲突?};
            E -->|是| F[移除多余依赖];
            E -->|否| G[检查插件版本];
            G --> H{插件匹配?};
            H -->|否| I[升级插件];
            H -->|是| J[禁用实验性功能];