Kotlin Android应用中FloatingActionButton添加Badge报错排查

问题重现 #

执行为FloatingActionButton添加徽章的代码时，抛出以下异常：

java.lang.IllegalArgumentException: The style on this component requires your app theme to be Theme.MaterialComponents (or a descendant).
at com.google.android.material.internal.ThemeEnforcement.checkTheme(ThemeEnforcement.java:241)
at com.google.android.material.internal.ThemeEnforcement.checkMaterialTheme(ThemeEnforcement.java:215)
at com.google.android.material.badge.BadgeDrawable.(BadgeDrawable.java:464)
at com.google.android.material.badge.BadgeDrawable.createFromAttributes(BadgeDrawable.java:353)
at com.google.android.material.badge.BadgeDrawable.create(BadgeDrawable.java:321)
...

执行代码：

val badge = BadgeDrawable.create(applicationContext)
BadgeUtils.attachBadgeDrawable(badge, binding.fab, null)

用户已完成配置：

• theme.xml继承自Theme.MaterialComponents.DayNight.DarkActionBar
• AndroidManifest.xml已应用该主题
• 尝试更换其他MaterialComponents系列主题，报错仍存在

解决方案 #

1. 替换ApplicationContext为Activity的Context #

BadgeDrawable的主题校验依赖当前Activity的Context，而非全局的ApplicationContext。ApplicationContext的主题未携带Activity级别的Material主题配置，会导致校验失败。修改代码如下：

// 在Activity中使用this，在Fragment中使用requireContext()
val badge = BadgeDrawable.create(this)
BadgeUtils.attachBadgeDrawable(badge, binding.fab, null)

2. 检查全量主题配置 #

确保所有层级的主题都正确继承MaterialComponents：

• 确认全局主题（res/values/themes.xml）的父主题为Theme.MaterialComponents.*系列
• 若单个Activity在Manifest中单独指定了android:theme属性，需确保该主题同样继承自MaterialComponents
• 排查是否存在自定义控件style覆盖Material主题特性的情况

3. 校验Material Components依赖版本 #

确保项目依赖的Material Components库版本与compileSdk、targetSdk版本兼容，避免版本不匹配导致的主题校验逻辑异常。示例依赖配置（build.gradle Module级别）：

implementation 'com.google.android.material:material:1.9.0' // 可替换为最新兼容版本

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