RecyclerView 数据未显示的常见原因及解决方案-java教程-PHP中文网

本文详解 recyclerview 未渲染数据的核心问题：fragment 中重复 inflate binding 导致视图绑定失效，并提供完整修复步骤、代码示例与最佳实践。

本文详解 recyclerview 未渲染数据的核心问题：fragment 中重复 inflate binding 导致视图绑定失效，并提供完整修复步骤、代码示例与最佳实践。

在 Android 开发中，使用 ListAdapter 配合 submitList() 是填充 RecyclerView 的标准方式，但若界面始终空白，往往并非数据或适配器逻辑错误，而是视图初始化与返回不一致这一隐蔽陷阱所致。

你当前代码的关键问题在于：在 onCreateView() 中创建了两份独立的 HomeFragmentBinding 实例：

第一份（binding）用于设置 tabLayout、rvProducts 引用并调用 setupRecyclerView()；
第二份（HomeFragmentBinding.inflate(inflater).getRoot()）被直接返回，但其内部的 RecyclerView 从未被配置过——既无 Adapter，也无 LayoutManager，更未接收任何数据。

因此，尽管 productsAdapter.submitList(products) 成功执行，它更新的是第一个绑定对象中的适配器，而最终显示在界面上的却是第二个未配置的 RecyclerView 实例，自然无法显示任何内容。

✅ 正确做法是：复用已配置完成的 binding 实例，仅返回其根视图：

@Override
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
    // ✅ 唯一一次 inflate，后续所有操作基于此 binding
    HomeFragmentBinding binding = HomeFragmentBinding.inflate(inflater);

    tabLayout = binding.tabLayout;
    rvProducts = binding.rvProducts;

    setupRecyclerView(); // 已为 binding.rvProducts 设置 adapter 和 layout manager

    viewModel.getAllProducts();

    viewModel.products.observe(getViewLifecycleOwner(), products -> {
        Log.d("HSV", "Received " + products.size() + " products");
        productsAdapter.submitList(products); // 更新的是已绑定到 UI 的 adapter
    });

    // ✅ 返回同一 binding 的根视图，确保配置生效
    return binding.getRoot();
}

⚠️ 注意事项：

ListAdapter.submitList() 是线程安全的，可在主线程外调用，但务必确保 RecyclerView 已完成初始化（即 setAdapter() 已执行）；
getViewLifecycleOwner() 是 Fragment 中观察 LiveData 的推荐作用域，可避免内存泄漏；
若 Product 类未重写 equals() 和 hashCode()，DiffUtil.ItemCallback.areContentsTheSame() 可能失效，建议补充实现（例如基于 ID + title + price 等关键字段判断）；
使用 ViewBinding 时，永远遵循「inflate 一次 → 配置一次 → 返回一次」原则，避免重复 inflate。

? 补充建议：为提升可维护性，可将 setupRecyclerView() 改为接收 RecyclerView 参数，进一步解耦：

private void setupRecyclerView(RecyclerView recyclerView) {
    productsAdapter = new ProductsAdapter();
    recyclerView.setAdapter(productsAdapter);
    recyclerView.setLayoutManager(new GridLayoutManager(requireContext(), 2));
}
// 调用处改为：setupRecyclerView(binding.rvProducts);

至此，RecyclerView 将正确响应 submitList() 并渲染数据。记住：视图配置与视图展示必须指向同一个实例——这是 Android 视图绑定开发中最易忽视却至关重要的基础原则。