Android DataBinding 为什么ViewStub找不到setLayout BindingAdapter

• 触发编译报错的核心逻辑：当DataBinding无法将XML节点上的自定义属性匹配到已注册的BindingAdapter时，会默认把该属性当成需要透传给ViewStub inflate后子布局的命名变量，自动生成调用binding.setVariable(BR.xxx, value)的逻辑。但因为属性没有匹配到有效适配器，注解处理器不会在BR类中生成对应字段，就会抛出“cannot find symbol variable xxx”的编译错误。
• 你的setLayout适配器匹配失败的具体诱因：
  1. 参数类型不兼容：你写的BindingAdapter方法接收非空String类型参数，但XML中传入的viewModel.searchRuleset通常是可空的String?类型。DataBinding的匹配规则中，非空参数的适配器无法匹配可空类型的表达式，会直接判定该属性和你的适配器无关，走透传变量逻辑。
  2. 通用命名的匹配歧义：setLayout是过于宽泛的命名，容易和DataBinding内部自动扫描View公开setter方法生成绑定属性的规则产生优先级冲突，导致自定义适配器不被优先识别。
  3. 无效属性的干扰：你在ViewStub节点上写的app:viewModel="@{viewModel}"没有对应的BindingAdapter实现，会被系统当成透传变量处理，进一步打乱属性匹配逻辑。
• 同文件下其他BindingAdapter没有报错的原因：这些适配器的参数类型和传入的表达式类型完全匹配、命名无通用冲突，因此可以被正常识别注册，不会走透传变量的错误逻辑。

1. 调整BindingAdapter的参数为可空类型，兼容XML的可空表达式，同时替换为无歧义的专属属性名：

   @BindingAdapter("app:viewStubLayout")
   fun ViewStub.setViewStubLayout(rule: String?) {
       layoutResource = when (rule) {
           "retailfood" -> R.layout.stub_code_details_retail_food
           "general" -> R.layout.stub_code_details_general
           "recwater" -> R.layout.stub_code_details_recwater
           "citations" -> R.layout.stub_code_details_citations
           else -> R.layout.stub_code_details_other
       }
   }
   

2. 同步修改XML中ViewStub的属性为新的专属命名，移除无意义的手动透传属性：

   <ViewStub
       android:id="@+id/retailfood_viewStub"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:visibility="visible"
       app:viewStubLayout="@{viewModel.searchRuleset}" />
   

   注：如果需要给ViewStub inflate后的子布局传递viewModel变量，不需要在ViewStub节点上手动添加对应属性，DataBinding默认会把布局根节点声明的变量自动透传给inflate后的带绑定的子布局，手动写反而会触发额外报错。
3. 修改完成后执行一次项目清理（Build > Clean Project）再重新编译，避免旧的BR类缓存残留导致的报错。

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