网格RecyclerView使用ItemDecorator添加间距后部分item出现空白问题

问题复现 #

3列网格布局的RecyclerView，添加自定义ItemDecoration设置item间距后，部分item区域出现空白。

问题原因与修复方案 #

1. ItemDecoration逻辑问题 #

原ItemDecoration代码存在两处逻辑错误，可能导致item边距计算异常挤压显示空间：

• 行数计算逻辑错误
  原代码使用整数除法计算总行数：
  val numberOfRows = (parent.adapter?.itemCount?:-1)/numberOfColumns
  如果item总数量无法被列数整除，最后一行的行号会大于计算得到的numberOfRows，无法命中最后一行的边距判断分支，导致上下边距计算错误。
  修复方案改为向上取整计算行数：

val itemCount = parent.adapter?.itemCount ?: 0
val numberOfRows = ceil(itemCount / numberOfColumns.toDouble()).toInt()

• 边距参数混用错误
  原代码横向边距设置用了edgeSpacingVerticalDP参数，纵向边距设置用了edgeSpacingHorizontalDP参数，参数名和实际使用场景相反，传参时容易出错导致边距不符合预期。

2. Item布局问题（提问者验证的核心问题） #

原Item布局存在多个可能导致空白的问题：

• MaterialCardView默认携带内边距和兼容阴影边距，会挤压内部布局显示空间，可添加以下属性关闭：

app:cardUseCompatPadding="false"
app:contentPadding="0dp"

• ImageView的宽高比例约束没有明确方向，部分机型测量时可能出现异常，可将比例属性改为明确高度跟随宽度计算：

app:layout_constraintDimensionRatio="H,1:1"

• 图片加载失败、占位图尺寸不符合预期，加上fitXY缩放类型的特性，可能出现显示不全的问题，可替换为centerCrop缩放类型，同时配置明确的占位图和错误图。

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