Android应用切换深浅主题后RecyclerView背景显示异常问题求助

问题原因 #

这个异常背景是Android系统默认给RecyclerView附加的主题级背景，你没有主动设置背景时，RecyclerView会继承当前主题的?attr/colorSurface（MaterialComponents主题）或者?android:attr/colorBackground（传统AppCompat主题）的值，切换深浅主题时系统会自动更新这个主题属性值，你看到的陌生颜色就是系统主题自带的默认色值，不会存在于你自己项目的color.xml里。
你设置透明不生效的核心原因是RecyclerView默认启用了默认item动画的过渡绘制缓存，或者父布局重绘时把RecyclerView的背景属性重置回了主题默认值。

解决方案 #

• 方案1：全局覆盖RecyclerView的默认样式，在你app的主题里添加如下属性，彻底禁用RecyclerView的默认主题背景：

<item name="recyclerViewStyle">@style/Widget.AppCompat.RecyclerView.NoBackground</item>

然后在style.xml里新增对应的样式：

<style name="Widget.AppCompat.RecyclerView.NoBackground" parent="Widget.AppCompat.RecyclerView">
    <item name="android:background">@android:color/transparent</item>
</style>

• 方案2：如果你不想全局修改，在每个用到的RecyclerView的XML布局里强制设置背景，注意不要用@null，直接指定透明或者和根布局一致的背景色：

<androidx.recyclerview.widget.RecyclerView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/transparent"
    tools:itemCount="10"
    tools:listitem="@layout/xxx_item"/>

• 方案3：如果切换主题时你是手动调用recreate()刷新Activity，在onCreate里布局加载完成后，主动给RecyclerView重新设置一次背景：

// Kotlin代码示例
val recyclerView = findViewById<RecyclerView>(R.id.rv_list)
recyclerView.setBackgroundColor(Color.TRANSPARENT)
// 额外关闭默认的item动画可以避免切换主题时的item闪烁
recyclerView.itemAnimator = null

• 额外排查项：检查你是否给RecyclerView设置了android:requiresFadingEdge、android:fadingEdgeLength之类的边缘渐变属性，这类属性也会导致看起来像背景异常的视觉效果，不需要的话直接设为none即可。

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