Android项目从ProGuard迁移到R8构建时遇ArrayIndexOutOfBoundsException

从你贴出的错误栈来看，这个问题的根源非常明确——你的混淆规则（proguard-rules.pro）里存在R8无法正确解析的类匹配语法，ProGuard对规则的容错性更高，所以之前能正常构建，但R8的规则解析逻辑更严格，直接触发了数组越界异常。

以下是具体的排查和解决步骤，按优先级排序：

1. 立刻检查混淆规则中的通配符用法 #

错误栈里明确指向ProguardTypeMatcher$MatchTypePattern的解析逻辑出错，这通常是因为你写了不符合R8规范的通配符规则。比如：

• 错误写法：-keep class com.example.**.*Service（多了一层不必要的通配符嵌套）
• 错误写法：-keep class com.example.*.**Service（通配符顺序逻辑错误）
• 还有可能是拼写错误的类名、遗漏了包名分隔符，或者使用了*和**的错误组合。

建议重点排查所有包含通配符的-keep、-dontwarn、-assumenosideeffects规则，确保语法符合R8的要求：

• *匹配单个包或类名片段
• **匹配任意层级的子包和类

2. 逐步定位问题规则 #

如果一时找不到错误规则，可以用“二分法”快速排查：

• 先临时注释掉所有自定义的混淆规则，只保留Android默认的混淆模板（通常是proguard-android.txt）
• 尝试构建Release版本，如果能成功，再逐个恢复你的自定义规则，每次构建一次，直到触发错误，就能精准定位到出问题的那条规则。

3. 升级Android Gradle Plugin和R8版本 #

这个数组越界异常可能是R8的已知bug，新版本的AGP（Android Gradle Plugin）已经修复了很多这类解析问题。你可以在项目根目录的build.gradle里升级AGP版本：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2' // 替换为最新稳定版，比如当前最新的8.x系列
    }
}

4. 开启R8调试日志辅助排查 #

如果还是找不到问题，可以开启R8的详细日志，查看它在处理哪些规则时出错：

• 在项目的gradle.properties里添加：

  android.enableR8.fullMode=true
  android.debug.obsoleteApi=true
  

• 或者用命令行构建时添加日志参数：

  ./gradlew assembleRelease --info
  

  日志里会显示R8处理每一条规则的细节，帮你快速定位问题。

总的来说，这个问题90%以上都是混淆规则的语法问题，只要找到并修正那条不符合R8规范的规则，就能解决这个构建错误。

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