Android RecyclerView加载文档时出现额外换行/空白问题求助

现象 #

• 15条列表场景：
  • 点击第1条：文档顶部正常，末尾多出约14个换行
  • 点击中间条目（如第8条）：顶部和末尾各多出7个换行
  • 点击最后1条：顶部多出约14个换行，末尾正常
• 单条列表场景：无任何额外空白
• 额外空白数量与列表总条数、当前点击位置强相关，滚动列表后空白会累加，甚至出现内容重复

调试日志 #

滚动列表时onBindViewHolder()会多次触发，若注释掉holder.bind("");，换行数量会进一步增加，滚动回顶部后空白持续累加，同一文档内容重复出现。

已尝试无效方案 #

• 优化onBindViewHolder()逻辑，移除冗余操作
• 验证ViewHolder视图复用逻辑
• 调用notifyDataSetChanged()通知适配器更新
• 调整onBindViewHolder条件逻辑，确保每个item重置TextView
• 执行清理/重建项目操作

相关代码 #

onBindViewHolder方法 #

@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    Log.d("SteList", "(SongLyricsAdapter) - line #83 - onBindViewHolder called");
    Songs song = dbHelper.getSongDetailsById((int) songsList.get(position).getSongId());
    if (position == selectedSongPosition) {
        // Load the lyrics of the selected song
        String songURI = song.getSongURI();
        String songFileName = song.getSongFileName();
        String lyrics = loadSongLyrics(context, songURI, songFileName);
        
        // Reset TextView state
        holder.lyricsTextView.setText(""); // Clear previous text
        holder.lyricsTextView.setScrollY(0); // Scroll to the top

        // Trim and set the lyrics
        String trimmedLyrics = lyrics.trim();
        holder.bind(trimmedLyrics);

    } else {
        // Clear the lyrics for other positions
        holder.bind("");
    }
}

TextView布局 #

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/lyricsTextView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="Song Content"
    android:textSize="16sp"
    android:padding="16dp" />

解决思路与方案 #

1. 检查并修正ViewHolder的bind方法 #

优先确认bind()方法的实现，确保是替换文本而非追加：

public void bind(String text) {
    // 必须用setText，不能用append
    lyricsTextView.setText(text);
    // 强制重置滚动位置
    lyricsTextView.setScrollY(0);
}

如果之前用了append，会导致每次复用ViewHolder时都在原有内容后追加，直接引发空白累加。

2. 彻底清除ViewHolder复用残留 #

在bind方法中重置所有可能影响布局的属性，避免旧布局状态残留：

public void bind(String text) {
    lyricsTextView.setText(text);
    lyricsTextView.setScrollY(0);
    // 重置高度与行数限制，避免旧布局尺寸残留
    lyricsTextView.setMaxLines(Integer.MAX_VALUE);
    lyricsTextView.setLayoutParams(new ViewGroup.LayoutParams(
        ViewGroup.LayoutParams.MATCH_PARENT,
        ViewGroup.LayoutParams.WRAP_CONTENT
    ));
}

3. 重构适配器逻辑：避免多Item复用导致的问题 #

你的场景是"左右滑动切换单个文档"，而非展示所有文档列表，因此用RecyclerView承载15个Item本身不合理：

• 方案一：直接用单个TextView展示当前文档，左右滑动时更新TextView的文本内容，无需RecyclerView
• 方案二：若坚持用RecyclerView，将Item数量设为1，仅显示当前选中的文档，切换时更新数据并调用notifyDataSetChanged()

4. 缓存已加载内容，避免重复IO操作 #

每次onBindViewHolder()都读取数据库+加载文件，不仅效率低，还可能导致重复加载引发的异常：

// 用HashMap缓存已加载的歌词内容
private HashMap<Integer, String> lyricsCache = new HashMap<>();

@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    Log.d("SteList", "(SongLyricsAdapter) - line #83 - onBindViewHolder called");
    Songs song = songsList.get(position);
    int songId = (int) song.getSongId();
    
    if (position == selectedSongPosition) {
        String lyrics;
        // 优先从缓存读取
        if (lyricsCache.containsKey(songId)) {
            lyrics = lyricsCache.get(songId);
        } else {
            String songURI = song.getSongURI();
            String songFileName = song.getSongFileName();
            lyrics = loadSongLyrics(context, songURI, songFileName).trim();
            lyricsCache.put(songId, lyrics);
        }
        
        holder.bind(lyrics);
        holder.lyricsTextView.setScrollY(0);

    } else {
        holder.bind("");
    }
}

5. 改用ViewPager2实现横向切换 #

针对"左右滑动切换文档"的需求，ViewPager2是更适配的组件，它专门处理页面切换，不会出现RecyclerView复用导致的布局残留问题：

• 创建ViewPager2，适配器中每个页面对应一个显示文档的TextView
• 点击列表时调用viewPager.setCurrentItem(position)跳转到对应页面
• 每个页面的TextView独立管理，彻底规避复用带来的空白累加问题

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