RecyclerView（嵌套CardView）加载JSON后页面空白问题排查及解决

Hey there, let's troubleshoot why your RecyclerView nested inside a CardView is showing up blank even after trying to load JSON data. I’ve run into this exact issue a few times, so let’s break down the most likely culprits across your files and fix them step by step.

• RecyclerView/CardView Height Issues: If your RecyclerView uses wrap_content as its height and your data hasn’t loaded yet, it’ll collapse to 0 height (looking blank). Make sure your RecyclerView has a fixed height, match_parent, or use wrap_content with a LayoutManager that supports it (most modern versions do, but double-check). Also confirm your parent CardView has enough space to display the RecyclerView.
• Item Layout Visibility: In items.xml, ensure your item’s root layout isn’t set to visibility="gone", and that individual views (like TextViews) have proper padding/margins so content isn’t clipped. Try adding a solid background color to your item layout temporarily—if you see the background but no text, the issue is data binding, not layout.
• ID Mismatch: Double-check that you’re using the correct ID for your RecyclerView in MainActivity.java when calling findViewById(). A wrong ID means you’re not referencing the actual RecyclerView in your layout.

• Missing LayoutManager: This is the #1 reason for blank RecyclerViews! You must set a LayoutManager on your RecyclerView in MainActivity—without it, the RecyclerView doesn’t know how to arrange items. Example:

  recyclerView.setLayoutManager(new LinearLayoutManager(this));
  

• Incorrect getItemCount(): If your adapter returns 0 here (or a fixed number instead of your data list’s size), the RecyclerView will show nothing. Make sure it’s returning the size of your user list:

  @Override
  public int getItemCount() {
      return mUserList != null ? mUserList.size() : 0;
  }
  

• Forgot to Call notifyDataSetChanged(): After updating your adapter’s data list (once JSON is parsed), you need to tell the RecyclerView the data has changed. If you skip this, the UI won’t update. Call it right after adding new data:

  mUserList.addAll(parsedUsers);
  mAdapter.notifyDataSetChanged();
  

• Broken Data Binding: In onBindViewHolder(), confirm you’re correctly mapping User object fields to your item views. For example, if you have user.getName() but your TextView ID is R.id.tv_username instead of R.id.tv_name, the text won’t show up (making items look blank). Add a log here to verify the data is valid:

  Log.d("UserAdapter", "Binding user: " + user.getName());
  

• Network/JSON Loading on Main Thread: If you’re fetching or parsing JSON on the main thread, you’ll get an ANR (Application Not Responding) and your data won’t load properly. Use AsyncTask, Kotlin Coroutines, or libraries like Retrofit/Volley to handle network operations in a background thread, then update the adapter on the main thread.
• Empty Data List: After parsing JSON with QueryUtils, log the size of your user list. If it’s empty, the problem is in your JSON parsing logic (not the RecyclerView). Example:

  List<User> users = QueryUtils.fetchUserData();
  Log.d("MainActivity", "Fetched users: " + users.size());
  

• Field Mismatch: Ensure your User class fields exactly match the keys in your JSON. For example, if your JSON has a full_name key but your User class uses fullName without proper Gson annotations (or manual parsing), the field will be null, leading to blank items.
• Broken JSON Parsing: Check QueryUtils for parsing mistakes—like trying to get a string with getInt(), or not iterating through the correct JSON array. Add try-catch blocks with error logs to catch parsing exceptions:

  try {
      // JSON parsing logic here
  } catch (JSONException e) {
      Log.e("QueryUtils", "Error parsing JSON data", e);
  }
  

1. Log your user list size right after parsing—if it’s 0, fix QueryUtils.
2. Verify your RecyclerView has a LayoutManager set.
3. Check that getItemCount() returns your list’s size.
4. Add a background color to your item layout to confirm items are being created (even if empty).
5. Log the data being bound in onBindViewHolder() to ensure it’s not null.

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