Android 9+设备中ListView项不显示但可响应点击的问题求助

使用Android Studio + Java开发的应用中，PromotionsFragment内实现了带粘性头部的ListView，在Android 7设备上运行正常，列表项和OnItemClickListener工作符合预期；但在Android 9及以上设备出现以下问题：

• 列表外观为空，无可见子项
• 点击不可见项的对应位置时，OnItemClickListener可正常触发
• 列表已填充数据且功能正常，但项的文本/内容未显示

已尝试的操作：

• 确认Adapter设置正确、数据传递无误
• 替换为普通ListView，问题仍存在
• Logcat无错误/警告信息

1. 文本颜色与背景色重合 #

Android 9+的系统主题或AppCompat主题可能默认修改了文本颜色，导致文本颜色与列表项背景色一致（比如白色文本在白色背景上），视觉上不可见但视图实际存在。

解决办法：

• 在列表项布局的TextView中明确设置android:textColor属性，例如：

<TextView
    android:id="@+id/item_text"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:textColor="@color/black" />

• 检查应用主题中textColorPrimary、textColorSecondary等属性，确保在高版本系统下不会与背景色冲突。

2. 视图可见性或透明度异常 #

Adapter的getView()方法中，可能存在根据系统版本判断的逻辑，在Android 9+下错误将视图设置为INVISIBLE或透明度alpha=0；或者复用convertView时未重置视图状态。

解决办法：

• 在getView()中强制设置视图可见性和透明度：

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    // ... 初始化视图逻辑
    TextView itemText = convertView.findViewById(R.id.item_text);
    itemText.setVisibility(View.VISIBLE);
    itemText.setAlpha(1f);
    itemText.setText(dataList.get(position).getContent());
    // ...
}

• 排查是否有针对Android版本的条件判断代码，确保高版本系统下视图状态正确。

3. 硬件加速兼容性问题 #

Android 9+对硬件加速的处理逻辑有调整，某些自定义视图、复杂布局在硬件加速模式下会出现显示异常，但视图的触摸区域仍正常。

解决办法：

• 给ListView或列表项布局禁用硬件加速：
  • XML方式：在ListView标签中添加android:layerType="software"
  • 代码方式：

listView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);

4. 布局尺寸或内边距异常 #

列表项布局的宽度/高度设置错误，或者内边距（padding）过大，导致内容被挤出可视区域，但视图本身的点击区域仍存在。

解决办法：

• 检查列表项布局的layout_width、layout_height设置，确保为match_parent或合适的固定值，避免wrap_content导致的尺寸计算错误；
• 检查布局中padding、margin属性，确保内容不会被挤出视图边界。

5. Adapter复用逻辑错误 #

复用convertView时，未正确重置控件的内容或状态，例如之前的复用项中文本被设置为空，且在当前项未重新赋值。

解决办法：

• 在getView()中，无论是否复用convertView，都要明确为控件设置内容，不要依赖复用视图的原有状态：

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        convertView = LayoutInflater.from(context).inflate(R.layout.list_item, parent, false);
        holder = new ViewHolder();
        holder.itemText = convertView.findViewById(R.id.item_text);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }
    // 强制设置文本内容，覆盖复用状态
    holder.itemText.setText(dataList.get(position).getContent());
    return convertView;
}

static class ViewHolder {
    TextView itemText;
}

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