这种情况在AGP版本升级时挺常见的，核心原因是当本地库作为app模块的依赖进行整体编译时，AGP的资源处理逻辑和单独编译库模块完全不同，以下是具体的排查方向和解决方案：

可能的原因及对应解决步骤 #

1. 缓存导致的资源生成异常 #

单独编译库时生成的R类缓存，在整体编译app时可能和合并后的资源冲突，或者旧缓存未被清理，导致新的R类无法正确生成。

• 执行彻底清理命令：./gradlew clean assembleDebug，不要跳过clean步骤，确保所有旧的生成文件被删除后重新构建。

2. Kotlin与AGP版本兼容性问题 #

你使用的Kotlin 1.2.21和AGP 3.0.1之间可能存在适配小问题，AGP 3.0.x推荐搭配Kotlin 1.2.30及以上版本（虽然1.2.21理论上兼容，但小版本差异可能导致编译顺序异常）。

• 尝试升级Kotlin版本到1.2.30或更高（在项目根目录的build.gradle中修改ext.kotlin_version的值），然后同步gradle并重新编译。

3. 资源冲突或AAPT2的严格校验 #

即使单独编译库没问题，当合并app和lib的资源时，可能出现资源重名、资源文件格式错误（比如文件名含大写字母、XML语法错误），这些问题在AAPT2模式下会导致资源生成中断，但单独编译库时可能未被触发。

• 检查两个模块中是否有同名的资源（比如drawable、string等），重命名冲突的资源；
• 检查lib模块的资源文件是否符合AAPT2的规范：文件名只能用小写字母、数字、下划线和连字符，XML文件没有语法错误；
• 确认android.enableAapt2=false确实生效：在gradle.properties中设置后，点击Android Studio的"Sync Project with Gradle Files"，或者执行./gradlew --stop终止gradle daemon后再重新编译。

4. 库模块的Gradle配置问题 #

确保lib模块的build.gradle中正确应用了Kotlin插件，并且依赖配置正确：

• 检查lib模块的build.gradle顶部是否有apply plugin: 'kotlin-android'（如果用了视图绑定或数据绑定，还要加上apply plugin: 'kotlin-android-extensions'）；
• 确认app模块对lib的依赖声明正确：使用implementation project(':lib')（AGP3.0+推荐）或compile project(':lib')，不要有拼写错误。

5. R类导入错误 #

虽然你说两个模块包名一致，但还是要确认lib模块的代码中是否正确导入了自身的R类：

• 检查lib模块的Kotlin文件中，导入的是com.yourpackage.R，而不是其他模块的R类；
• 避免使用import android.R，这是常见的错误来源。

为什么单独编译lib正常，编译app时出问题？ #

简单来说：

• 单独编译lib时，AGP会为lib独立生成R类，资源只来自lib自身，没有合并过程，所以不会触发跨模块的资源冲突或编译顺序问题；
• 当编译app时，AGP会先合并app和所有依赖模块的资源，再生成各个模块的R类（库模块的R类在AGP3.0+中是final类，静态引用合并后的资源），如果合并过程中出现任何异常，都会导致lib的R类无法正确生成，进而被Kotlin编译器报“Unresolved reference”。

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