CardView默认elevation适配问题：API≤22时Badge被遮挡

阿华AIGC实验室

2026-5-6

为什么CardView默认elevation在API<=22和>22版本有差异，导致徽章被遮挡？

你碰到的这个问题本质是CardView在不同Android版本下，默认elevation的实际生效逻辑不一样，咱们一步步说清楚：

核心原因拆解

API 23及以上：CardView直接使用系统原生的elevation属性，默认值是CardView.DEFAULT_ELEVATION，也就是2dp。这时候你给徽章设2dp的elevation，因为徽章在XML布局里是写在CardView之后的，绘制顺序靠后，所以能正常显示在CardView上方。
API 22及以下：这时候Android系统还没有完全原生支持elevation阴影，CardView是通过模拟阴影（给CardView加额外padding，再绘制带阴影的背景Drawable）来实现视觉效果的。它的默认elevation会被转换成一个更高的"有效层级"——具体来说，内部会把2dp的默认值转换成像素后，再通过映射计算对应到模拟阴影的强度，最终这个"有效elevation"大概是2.2857dp左右。这就是为什么你把徽章的elevation改成这个数值后，就能正常显示了。

你可以在API<=22的设备上跑一段代码，打印CardView的实际elevation值：

// Java代码
CardView cardView = findViewById(R.id.your_cardview_id);
Log.d("CardViewElevation", "实际elevation像素值: " + cardView.getElevation() + "px");

或者Kotlin：

// Kotlin代码
val cardView = findViewById<CardView>(R.id.your_cardview_id)
Log.d("CardViewElevation", "实际elevation像素值: ${cardView.elevation}px")

把得到的像素值转换成dp（公式：dp = px / 设备密度），你会发现结果刚好接近2.2857dp，和你测试的数值完全匹配。

硬编码这个奇怪的数值虽然能解决问题，但不够优雅，推荐这几个通用方案：

显式指定CardView的elevation：不管API版本，给CardView设置明确的app:cardElevation="2dp"，然后给徽章设置比这个值稍大的elevation（比如2.1dp），这样在所有版本下都能保证徽章在CardView上方。
用translationZ替代elevation：在低版本中，translationZ可以直接调整视图的绘制层级优先级，给徽章设置android:translationZ="2dp"，不管CardView的elevation是多少，徽章都会显示在最上层。
结合布局顺序：你已经把徽章放在CardView之后了（XML中顺序靠后，绘制顺序更晚），但低版本下elevation的优先级更高，所以搭配上面的方法效果更可靠。