Android Studio activity_main加Button后AVD应用闪退问题

添加id为button_add的Button后启动崩溃，属于Android布局inflate阶段的典型错误，按以下优先级排查修复即可：

• 最高发原因：控件类型不匹配
  如果你在Kotlin代码里用findViewById或者旧版Kotlin合成引用直接调用这个Button，大概率是import错了控件类：

  • 布局里写的是原生<Button>标签，代码里却导入了com.google.android.material.button.MaterialButton
  • 反过来布局里用了MaterialButton，代码里导入的是原生Button类
    这类错误会直接抛出ClassCastException，启动瞬间崩溃，删掉控件因为找不到对应引用的触发点就不会报错。
    修复方式：对齐两边的控件类型，要么统一用原生Button，要么统一用MaterialButton，同时确认Material依赖已经在模块级build.gradle中引入，且App主题继承自MaterialComponents系列主题。

• 第二高发原因：构建缓存导致R类id映射错乱
  旧的构建缓存会导致新增的控件id和R类里的映射不匹配，inflate时直接抛异常。
  修复方式：依次执行Build -> Clean Project、Build -> Rebuild Project，卸载AVD中已安装的旧版本应用后重新运行即可。

• 第三类常见原因：Button配置的属性不合法
  重点检查Button上的属性配置：

  • 如果写了android:onClick="xxx"属性，必须在MainActivity中存在签名完全匹配的公开方法：方法名和属性值一致，仅接收一个View类型参数，否则启动时会抛出NoSuchMethodException
  • 不要给属性传错值类型，比如把尺寸属性赋值为普通字符串、给layout_width/height留空，这类问题会直接触发InflateException
  • 如果用了Material专属属性（比如app:cornerRadius），不要在非Material主题的布局中使用。

• 第四类原因：视图绑定代码写错
  如果你开启了ViewBinding，注意：

  1. onCreate中必须先用inflate方法生成binding实例，再把binding.root传入setContentView()，不要直接传布局id
  2. ViewBinding会把下划线命名的id自动转成驼峰，button_add对应的引用是binding.buttonAdd，不要写错名称
     规范写法参考：

  private lateinit var binding: ActivityMainBinding
  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      binding = ActivityMainBinding.inflate(layoutInflater)
      setContentView(binding.root)
      // 控件调用示例
      binding.buttonAdd.setOnClickListener {
          // 点击逻辑
      }
  }
  

快速定位技巧 #

如果以上步骤没覆盖到你的场景，直接翻Logcat中FATAL EXCEPTION块下第一行Caused by:开头的错误信息：

• 报ClassCastException：直接回去改控件import的类型
• 报InflateException：看错误信息里提到的属性名，对应修正布局里的属性配置
• 报NullPointerException：检查是不是在setContentView执行之前就调用了这个Button的相关方法
• 报NoSuchMethodException：修正android:onClick对应的方法签名

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