使用Hilt时出现Unsupported nesting LOCAL编译错误问题咨询

问题根因 #

这个报错和Hilt依赖图配置错误无关，是Hilt 2.42版本内嵌的XProcessing注解处理工具的已知缺陷：当注解扫描流程碰到方法内部定义的局部类时，类型描述符生成逻辑无法识别LOCAL层级的类嵌套类型，会直接抛出异常中断编译。
注意：提交的依赖声明里存在笔误，com.google.dagger:hilt-android:2:42的版本号多写了一个冒号，正确写法应为com.google.dagger:hilt-android:2.42，该笔误不是触发本次报错的核心原因。

问题提交者使用的环境版本 #

• Java版本：11
• Hilt Gradle插件：com.google.dagger:hilt-android-gradle-plugin:2.42
• Hilt核心依赖：com.google.dagger:hilt-android:2.42
• Hilt编译器：androidx.hilt:hilt-compiler:1.0.0

核心报错信息 #

编译任务:demo:hiltJavaCompileDebug、:demo:hiltJavaCompileRelease执行失败，抛出异常：

java.lang.IllegalStateException: Unsupported nesting LOCAL

异常堆栈触发点为XProcessing工具的Kotlin元数据解析逻辑，对应代码位置：dagger.spi.shaded.androidx.room.compiler.processing.javac.kotlin.JvmDescriptorUtilsKt.getInternalName

解决方法 #

• 推荐方案：直接将Hilt版本升级到2.43及以上，该缺陷在2.43版本更新内嵌XProcessing库时已被官方修复，升级后无需调整业务代码即可正常完成编译
• 临时兼容方案（暂无法升级Hilt版本时使用）：排查所有被Hilt相关注解标注的类，检查这些类的方法中是否定义了局部类（即写在方法体内部的类），将这类局部类挪到方法外部，作为类的普通嵌套类定义，即可绕过注解处理的解析bug

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