Android Studio按钮背景图片显示异常问题求助

核心原因 #

问题大概率出在Material组件按钮的默认 tint 特性或者主题中按钮相关颜色属性的覆盖。Android的MaterialButton会继承主题里的颜色配置，比如colorButtonNormal、colorSurface，这些属性会给按钮背景加上一层染色，哪怕你设置了自定义背景图，也会被这层黑色 tint 覆盖；另外如果之前修改主题时误改了按钮相关的颜色值，也会导致这个问题。

具体解决方案 #

1. 关闭MaterialButton的背景Tint

如果你用的是MaterialButton，直接在布局里禁用它的背景染色功能：

<com.google.android.material.button.MaterialButton
    android:id="@+id/your_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="你的按钮文字"
    android:background="@drawable/your_custom_bg"
    app:backgroundTint="@null" <!-- 关键：关闭背景染色 -->
    android:textColor="@color/your_text_color" /> <!-- 确保文字颜色和背景区分开 -->

2. 改用普通Button组件

如果不需要MaterialButton的特性，直接换成原生Button，它不会自动应用主题的tint：

<Button
    android:id="@+id/your_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="你的按钮文字"
    android:background="@drawable/your_custom_bg"
    android:textColor="@color/your_text_color" />

3. 排查theme.xml中的按钮相关属性

打开你修改过的theme.xml，检查是否存在以下会影响按钮颜色的配置，如有则移除或修改：

<style name="Theme.YourApp" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 你的状态栏颜色设置 -->
    <item name="android:statusBarColor">@android:color/black</item>
    
    <!-- 移除或修改这些可能导致按钮变黑的属性 -->
    <!-- <item name="colorButtonNormal">@android:color/black</item> -->
    <!-- <item name="colorSurface">@android:color/black</item> -->
</style>

4. 验证背景图本身是否正常

先把背景图放到ImageView里测试，确认图片能正常显示，排除图片损坏或放置路径错误的问题：

<ImageView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/your_custom_bg" />

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