Android按钮设置背景图片失败：始终显示默认底色

核心原因 #

当前Android默认的Button控件是MaterialButton（Material Design组件），它自带的backgroundTint（背景色调）会强制覆盖你设置的android:background属性，导致自定义背景图被默认底色遮挡。

解决方案 #

方案1：取消默认背景色调（最简单） #

在Button标签中添加app:backgroundTint="@null"，同时保留原有的背景图设置，就能让自定义背景图正常显示：

<Button
    android:id="@+id/button"
    android:layout_width="170dp"
    android:layout_height="110dp"
    android:layout_marginTop="136dp"
    android:layout_marginEnd="124dp"
    android:text="@string/button"
    android:textColor="#05F192"
    android:textSize="20sp"
    android:background="@drawable/button"
    app:backgroundTint="@null" <!-- 关键：关闭默认色调覆盖 -->
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/textView" />

方案2：改用原生Android Widget.Button #

如果不需要Material Design的交互特性，直接指定使用原生Button控件，彻底避开Material样式的干扰：

<android.widget.Button
    android:id="@+id/button"
    android:layout_width="170dp"
    android:layout_height="110dp"
    android:layout_marginTop="136dp"
    android:layout_marginEnd="124dp"
    android:text="@string/button"
    android:textColor="#05F192"
    android:textSize="20sp"
    android:background="@drawable/button"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/textView" />

方案3：优化Selector状态布局（适配点击效果） #

你之前写的Selector布局可以继续使用，但需要搭配app:backgroundTint="@null"才能生效，同时确保Selector文件正确关联图片资源：

<Button
    ...
    android:background="@drawable/your_selector_file" <!-- 替换为你的Selector文件名 -->
    app:backgroundTint="@null"
    ... />

额外检查项 #

• 确认图片资源（button.png/icon.png）确实放在res/drawable或对应分辨率的drawable子目录下
• 资源文件名只能用小写字母、数字、下划线，不能包含大写或特殊字符

内容的提问来源于stack exchange，提问作者TROY BAPTISTE miminbat