使用Litho的RecyclerCollectionComponent时报java.lang.LinkageError错误怎么解决

运行时抛出的错误如下：

java.lang.LinkageError: com.facebook.litho.sections.widget.RecyclerCollectionComponent

调用代码如下：

RecyclerCollectionComponent component = RecyclerCollectionComponent.create(c).section(
                    section
            ).setRootAsync(false).disablePTR(true).build();

LinkageError属于JVM类加载阶段抛出的错误，本质是JVM检测到目标类的定义存在冲突、不兼容问题，针对该场景常见触发原因如下：

• Litho多模块版本不匹配：RecyclerCollectionComponent属于litho-sections-widget模块，若项目内引入的litho-core、litho-sections-core、litho-sections-widget等Litho相关模块版本号不一致，不同版本间的类定义、方法签名存在差异，就会触发类链接错误
• 重复依赖冲突：项目同时引入了多个来源的Litho依赖，比如同时存在Maven远程依赖和本地Module引入的Litho代码，同一类的两份定义存在差异，加载时触发冲突
• 编译缓存异常：旧的编译缓存残留了过期的类文件，和新编译的代码不兼容
• API签名变更：当前使用的Litho版本中，RecyclerCollectionComponent的构造方法、你调用的setRootAsync、disablePTR方法的签名已经被修改，和调用代码不匹配，链接时无法找到对应类或方法

• 核对项目所有Litho相关依赖的版本号，确保所有Litho模块的版本完全一致，没有出现版本号混用的情况
• 执行依赖冲突检测，Gradle项目可执行./gradlew dependencies命令，搜索所有Litho相关依赖，确认是否存在重复引入、版本被强制覆盖的情况
• 清理编译缓存后重新构建，Android项目可执行./gradlew clean assembleDebug，同时清理IDE缓存（File -> Invalidate Caches）后重新编译
• 核对对应版本Litho的API定义，确认你调用的setRootAsync、disablePTR方法在当前版本中确实存在，是否存在方法被废弃、重命名、参数调整的情况

• 版本不匹配场景：统一所有Litho依赖的版本号，建议在Gradle的ext配置块中统一声明lithoVersion变量，所有Litho依赖都引用该变量避免版本混用
• 依赖冲突场景：排除多余的重复Litho依赖，确保整个项目只有一个来源、一个版本的Litho类库
• API变更场景：调整调用代码适配当前版本的API，例如部分高版本Litho中disablePTR已更名为disablePullToRefresh，setRootAsync配置项已移动到其他参数配置入口，按照对应版本的API要求修改调用代码即可
• 缓存异常场景：清理本地编译缓存、IDE缓存后重新构建即可解决

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