Android Studio旧项目报找不到兼容屏幕清单RuntimeException如何解决

AI 小北

2026-8-29

错误核心信息

调试旧Android Studio项目运行时报错，核心堆栈如下：

Caused by: java.lang.RuntimeException: Cannot find generated compatible screen manifests, file a bug

常见诱发原因

Gradle版本与项目绑定的Android Gradle Plugin（AGP）版本严重不匹配：旧项目通常锁定了低版本AGP，本地环境如果使用过高版本Gradle，会改变兼容屏清单文件的生成路径、甚至直接跳过对应生成任务，最终导致运行阶段找不到目标文件抛出异常。
构建缓存损坏：之前的异常中断构建、非正常关闭IDE等操作，会导致build目录下的中间生成文件残缺，增量构建时不会自动重新生成缺失的兼容屏清单。
构建任务依赖链断裂：如果在gradle.properties中开启了旧版AGP不支持的实验性构建优化开关（比如分离注解处理、非稳定版增量manifest合并选项），会导致打包阶段读取清单文件时，对应的生成任务还未执行。
依赖版本冲突：项目中引用了26及以下版本的老旧Support库，和当前环境的构建工具存在已知兼容问题，干扰manifest合并、生成流程。

排查修复步骤

按优先级从高到低操作：

清理损坏的构建缓存
关闭Android Studio，手动删除项目根目录下的.gradle文件夹、所有子模块下的build文件夹；重新打开项目，依次点击菜单栏Build > Clean Project，待执行完成后再点击Build > Rebuild Project，纯缓存导致的问题这一步即可解决。
对齐Gradle与AGP的官方匹配版本
打开项目根目录下的build.gradle文件，找到AGP的依赖声明（形如classpath 'com.android.tools.build:gradle:x.x.x'），对照官方版本兼容表修改gradle/wrapper/gradle-wrapper.properties中distributionUrl对应的Gradle版本，不要跨大版本混用。例如AGP 3.3.x对应Gradle 4.10.1+，AGP 4.1.x对应Gradle 6.5。同时注释掉gradle.properties中所有自定义的实验性构建开关，尤其是和注解处理、manifest合并相关的配置，先保证项目能正常跑通，再按需开启优化项。
修复依赖与配置冲突
如果前两步操作后仍报错，将项目中低于27.1.0版本的Support库升级到27.1.0及以上，有条件的可以直接迁移到AndroidX，规避老版本依赖的构建兼容bug。也可在模块级build.gradle的android配置块中添加如下配置，规避兼容屏清单生成的异常逻辑：
```
android {
    // 其余原有配置保持不变
    aaptOptions {
        additionalParameters "--no-version-vectors"
    }
}
```

注意：调试旧项目时禁止随意跨大版本升级AGP，老项目的构建脚本大多和创建时的AGP版本强绑定，跨大版本升级会触发大量连锁构建报错，优先使用项目原生指定的版本匹配链。

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