Android Studio自定义按钮背景不生效，如何规避Material主题覆盖？

在Material主题中，默认的Button或MaterialButton会被主题的tint属性覆盖背景色，导致自定义drawable无法生效。以下是经过验证的可行解决方案：

1. 正确使用MaterialButton（推荐方案） #

MaterialButton是Material主题的标准按钮组件，只需明确清空背景tint即可应用自定义drawable：

<com.google.android.material.button.MaterialButton
    android:id="@+id/loginButton"
    android:layout_width="wrap_content"
    android:layout_height="50dp"
    android:text="Login"
    android:textSize="18sp"
    android:textColor="#F9F9F9"
    android:fontFamily="@font/merriweather_regular"
    android:drawableEnd="@drawable/enter"
    android:background="@drawable/rounded_box"
    app:backgroundTint="@null" <!-- 关键：清空主题默认的tint -->
    android:layout_below="@id/passwordInput"
    android:layout_centerHorizontal="true"
    android:layout_marginTop="5dp"/>

注意：需确保项目已引入Material Components依赖（通常Android Studio新建项目默认包含）。

2. 自定义全局按钮样式（批量解决） #

如果需要多个按钮统一使用自定义背景，可在样式中全局配置：

步骤1：创建自定义按钮样式 #

在res/values/styles.xml中添加：

<style name="CustomButton" parent="Widget.MaterialComponents.Button">
    <item name="backgroundTint">@null</item>
    <item name="android:background">@drawable/rounded_box</item>
    <!-- 可添加其他默认属性，如文字颜色、字体等 -->
    <item name="android:textColor">#F9F9F9</item>
    <item name="android:textSize">18sp</item>
</style>

步骤2：应用样式 #

• 单个按钮引用：

<Button
    ...
    style="@style/CustomButton"/>

• 全局应用（修改App主题）：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
    ...
    <item name="buttonStyle">@style/CustomButton</item>
</style>

3. 排查潜在冲突点 #

如果以上方案仍无效，检查以下内容：

• 确认rounded_box.xml位于res/drawable根目录，未误放入drawable-vXX等版本特定目录
• 检查代码中是否动态设置了按钮背景或tint（如setBackgroundTintList()、setBackgroundColor()），覆盖了XML配置
• 确保主题未强制设置按钮背景色：检查styles.xml中主题的colorPrimary或buttonBackground属性，避免与自定义drawable冲突
• 执行File > Invalidate Caches / Restart，彻底清理缓存后重建项目

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