Android用Ibotta AOP插件引入firebase-auth后AspectJ抛IllegalStateException

报错的本质是：AspectJ 1.9.6版本自带的泛型签名解析器，没法识别Firebase Auth 20.0.3里Google自动生成的、带短横线的内部类泛型签名格式。
加上Ibotta AOP插件默认的织入扫描逻辑是遍历classpath下所有类做预处理，哪怕你的切面根本不匹配这些第三方库的类，只要扫描解析阶段碰到不认的格式就会抛异常中断流程，最后连带出现dex文件生成不全、运行时找不到Application类的连锁问题。

可落地的解决方法（按推荐优先级排序） #

• 优先调整AOP织入的扫描范围，完全跳过第三方库类
  Ibotta插件本身提供了织入范围的配置项，默认会全量扫描所有依赖的jar、aar里的类，我们只需要把扫描范围限定到自己项目编译生成的类路径，从根源上避开Firebase的异常类签名。
  在应用级build.gradle里追加如下配置即可：

  aop {
      // 仅对项目自身编译产生的类做织入，不再遍历所有外部依赖
      includeProjectClasses = true
      // 明确排除容易触发解析异常的第三方包路径，进一步缩小扫描范围
      exclude = [
          "com.google.firebase.**",
          "com.google.android.gms.**"
      ]
  }
  

  这个配置完全不影响你现有切面的功能——毕竟你定义的切点本身就只匹配com.example.aopdemo.*包下的方法，本来就不需要扫描第三方库的类，之前的报错全是插件默认的无意义全量扫描导致的。

• 次选：升级AspectJ核心版本到兼容修复版本
  1.9.6版本的泛型签名解析器确实存在识别异常类签名的bug，1.9.7及以上版本已经修复了这类兼容问题。直接调整相关依赖和插件配置即可：

  dependencies {
      implementation "org.aspectj:aspectjrt:1.9.7"
  }
  
  aop {
      // 手动覆盖插件内置的aspectjtools版本，确保解析器用修复后的版本
      aspectjToolsVersion = "1.9.7"
  }
  

  升级后就算扫描过程中碰到Firebase的特殊格式类签名，解析器也能正常处理，不会抛出IllegalStateException中断流程。

• 临时规避方案
  如果暂时不方便调整插件或AspectJ版本，可以先把Firebase Auth降到20.0.3之前的稳定版本（比如19.3.1），这个版本的Firebase内部类签名是符合AspectJ解析格式的，不会触发解析异常。但这个方法不适合长期用，后续升级Firebase版本时还是会碰到同样的问题。

常见踩坑提醒 #

• 不要试图通过收窄切面的切点规则来解决这个问题：插件在初始化阶段会遍历类路径所有类的签名做预处理，这个过程早于切点匹配逻辑，只要碰到解析不了的格式就会抛错，和你写的切点规则没有关系。
• 不要轻信Gradle的"构建成功"提示：因为AspectJ织入任务的异常没有被正确向上抛出，会出现织入流程中断但Gradle最终标记构建成功的假成功场景，必须检查织入阶段的日志，确认没有上述IllegalStateException才算构建正常。

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