Android Studio(Kotlin)：Fragment内RecyclerView无内容显示求助

一、先确认网络请求是否拿到有效数据 #

• 加日志打印：在网络请求的成功回调里打印数据列表长度，比如Log.d("HomeFragment", "数据量：${cerbungList.size}")，看是真没拿到数据还是数据为空
• 检查网络权限：AndroidManifest.xml里必须加<uses-permission android:name="android.permission.INTERNET" />；如果是Android 9+用了HTTP接口，还要在AndroidManifest.xml的application标签里加android:usesCleartextTraffic="true"
• 核对数据类与接口返回：检查数据类的属性名是否和接口JSON的key完全匹配，大小写、嵌套结构都不能错，必要时用@SerializedName注解做字段映射，比如：

  data class Cerbung(
      @SerializedName("cerbung_title") val title: String,
      @SerializedName("cerbung_content") val content: String
  )
  

二、检查RecyclerView的基础配置 #

• 必须设置布局管理器：在HomeFragment的onViewCreated里一定要写recyclerView.layoutManager = LinearLayoutManager(context)（或GridLayoutManager），没这个RecyclerView根本不会渲染
• 确认Adapter绑定时机：要么在数据加载完成后给RecyclerView设置Adapter，要么先设置空Adapter，等数据回来后更新Adapter并调用notifyDataSetChanged()
• 检查RecyclerView布局参数：布局文件里RecyclerView的宽高要设为match_parent，如果是wrap_content且数据为空，会直接看不到

三、排查Adapter代码问题 #

• 盯紧getItemCount()：这个方法必须返回数据列表的真实长度，比如return cerbungList.size，返回0肯定啥也不显示
• 检查item布局加载：onCreateViewHolder里的布局ID不能写错，比如LayoutInflater.from(parent.context).inflate(R.layout.item_cerbung, parent, false)，别把布局文件名打错
• 确认数据绑定逻辑：onBindViewHolder里要确保每个控件都正确赋值，比如holder.titleTv.text = item.title，检查控件ID和数据字段有没有对应错
• 数据更新要通知：网络请求拿到数据后，要么用adapter.submitList(newList)（如果是ListAdapter），要么更新Adapter的数据源后立刻调用adapter.notifyDataSetChanged()，只改列表不通知刷新没用

四、Fragment生命周期相关坑点 #

• 网络请求别太早发：别在onCreateView里就发起请求，此时View还没初始化完成，建议移到onViewCreated里执行
• 回调要切主线程：网络请求回调默认在子线程，更新UI（比如设置Adapter、刷新列表）必须切到主线程，用requireActivity().runOnUiThread { ... }或者Coroutine的withContext(Dispatchers.Main)

五、快速排查小技巧 #

• 给item布局加背景色：给item根布局设个显眼的背景（比如红色），如果有数据的话，就算文本为空也能看到item占位，能快速区分是数据问题还是布局问题
• 断点调试：在网络请求回调、Adapter的getItemCount、onBindViewHolder里加断点，看代码有没有走到，数据是否正确传递

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