RecyclerView布局异常求助：初始化布局错乱，滚动后恢复正常

Hey there, let's break down this RecyclerView layout glitch you're dealing with—this is a pretty common issue, so we can fix it step by step!

The core problem here is RecyclerView's view reuse mechanism. When your app initializes, the first batch of item views are created with default or incomplete state; once you scroll, those views get recycled and re-bound with proper data/configuration, which fixes the layout. Common root causes include:

• Forgetting to reset all view properties in onBindViewHolder (reused views retain old state)
• LayoutManager or ItemDecoration misconfiguration causing incorrect initial measurement
• Data loading/Adapter refresh timing issues (data isn't ready when initial layout runs)
• Item layout XML relying on dynamic content with no fallback defaults

Let's go through the most effective solutions in order:

1. Reset All View State in onBindViewHolder #

This is the #1 fix for reuse-related layout bugs. Never rely on view defaults—explicitly set every property that depends on your data every time you bind a view.

Example:

@Override
public void onBindViewHolder(MyViewHolder holder, int position) {
    ItemData data = mDataList.get(position);
    
    // Explicitly set text content
    holder.titleTv.setText(data.getTitle());
    holder.descTv.setText(data.getDesc());
    
    // Handle conditional visibility (critical for reused views!)
    if (data.hasIcon()) {
        holder.iconIv.setVisibility(View.VISIBLE);
        holder.iconIv.setImageResource(data.getIconRes());
    } else {
        holder.iconIv.setVisibility(View.GONE);
    }
    
    // Reset any other dynamic properties (background, text color, etc.)
    holder.itemView.setBackgroundColor(data.isSelected() ? Color.LIGHT_GRAY : Color.WHITE);
}

2. Validate LayoutManager & ItemDecoration #

• Ensure you're setting a LayoutManager correctly (never skip this!):

  recyclerView.setLayoutManager(new LinearLayoutManager(this));
  // For grids:
  // recyclerView.setLayoutManager(new GridLayoutManager(this, 2));
  

• Check ItemDecoration's getItemOffsets method—avoid dynamic calculations that might fail during initial layout. Use fixed values if possible, or ensure your calculation accounts for unmeasured views.

3. Refresh Adapter Only After Data Is Ready #

If you're loading data asynchronously, wait until the data is fully fetched before calling notifyDataSetChanged() or updateData(). For example:

// In your data loading callback (ViewModel, Retrofit, etc.)
dataRepository.loadItems(new DataCallback() {
    @Override
    public void onDataLoaded(List<ItemData> items) {
        mAdapter.updateData(items);
        // Optional: Force a layout refresh if needed
        // recyclerView.requestLayout();
    }
});

4. Fix Item Layout XML #

• If using wrap_content for views that depend on dynamic content, add fallback defaults (e.g., minHeight for TextViews) to prevent zero-size views during initial layout.
• Avoid nested layouts (e.g., LinearLayout inside RelativeLayout inside FrameLayout) as they can slow down measurement and cause initial layout errors.

Here's a clean, production-ready example to reference:

1. Item Layout (item_recycler.xml) #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:orientation="vertical"
    android:minHeight="80dp"> <!-- Fallback height for empty state -->

    <TextView
        android:id="@+id/tv_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="18sp"
        android:textStyle="bold"/>

    <TextView
        android:id="@+id/tv_desc"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="14sp"
        android:layout_marginTop="8dp"
        android:textColor="@android:color/darker_gray"/>

</LinearLayout>

2. Adapter & ViewHolder #

public class ItemAdapter extends RecyclerView.Adapter<ItemAdapter.ItemViewHolder> {

    private List<ItemData> mItems;

    public ItemAdapter(List<ItemData> items) {
        mItems = items;
    }

    @NonNull
    @Override
    public ItemViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_recycler, parent, false);
        return new ItemViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull ItemViewHolder holder, int position) {
        ItemData item = mItems.get(position);
        holder.titleTv.setText(item.getTitle());
        holder.descTv.setText(item.getDescription());
    }

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

    // Safe way to update data
    public void updateItems(List<ItemData> newItems) {
        mItems = newItems;
        notifyDataSetChanged();
    }

    public static class ItemViewHolder extends RecyclerView.ViewHolder {
        TextView titleTv;
        TextView descTv;

        public ItemViewHolder(@NonNull View itemView) {
            super(itemView);
            titleTv = itemView.findViewById(R.id.tv_title);
            descTv = itemView.findViewById(R.id.tv_desc);
        }
    }
}

// Data model
public class ItemData {
    private String title;
    private String description;

    public ItemData(String title, String description) {
        this.title = title;
        this.description = description;
    }

    public String getTitle() { return title; }
    public String getDescription() { return description; }
}

3. Activity Setup #

public class MainActivity extends AppCompatActivity {

    private RecyclerView mRecyclerView;
    private ItemAdapter mAdapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mRecyclerView = findViewById(R.id.recycler_view);
        mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
        mRecyclerView.addItemDecoration(new DividerItemDecoration(this, DividerItemDecoration.VERTICAL));

        // Initialize dummy data (replace with your actual data loading)
        List<ItemData> dummyItems = new ArrayList<>();
        for (int i = 1; i <= 20; i++) {
            dummyItems.add(new ItemData("Item " + i, "Description for item " + i));
        }

        mAdapter = new ItemAdapter(dummyItems);
        mRecyclerView.setAdapter(mAdapter);
    }
}

4. Activity Layout (activity_main.xml) #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

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