Android Paging Library给PagedList添加Header遇异常求助

看起来你遇到了两个典型的PagedList加Header/Footer的坑：先是滚动位置异常，改用AsyncPagedListDiffer后又丢失了所有数据项。核心问题在于你错误地在继承PagedListAdapter后又手动创建了一个AsyncPagedListDiffer——PagedListAdapter本身就是基于AsyncPagedListDiffer实现的，重复实例化会导致Adapter内部数据同步完全混乱，这就是除Header外其他项消失的直接原因。

下面是修正后的完整代码，我会逐点解释关键修改：

修正后的Adapter代码 #

class MerchantHistoryAdapter : PagedListAdapter<MerchantHistoryResponse.Transaction, BaseViewHolder>(MerchantHistoryDiffUtilCallback()) {
    lateinit var listener: HistoryItemListAdapterListener
    lateinit var headerListener: HistoryItemHeaderListAdapterListener
    lateinit var networkStateListener: NetworkStateListAdapterListener
    private var networkState: NetworkState = NetworkState.LOADING

    // 重写ListUpdateCallback，处理Header导致的位置偏移
    override fun getListUpdateCallback(): ListUpdateCallback {
        val originalCallback = super.getListUpdateCallback()
        return object : ListUpdateCallback {
            override fun onInserted(position: Int, count: Int) {
                originalCallback.onInserted(position + 1, count)
            }

            override fun onRemoved(position: Int, count: Int) {
                originalCallback.onRemoved(position + 1, count)
            }

            override fun onMoved(fromPosition: Int, toPosition: Int) {
                originalCallback.onMoved(fromPosition + 1, toPosition + 1)
            }

            override fun onChanged(position: Int, count: Int, payload: Any?) {
                originalCallback.onChanged(position + 1, count, payload)
            }
        }
    }

    override fun getItem(position: Int): MerchantHistoryResponse.Transaction? {
        return when (position) {
            0 -> null // Header位置无数据
            in 1..super.getItemCount() -> super.getItem(position - 1) // 数据项跳过Header偏移
            else -> null // NetworkState位置无数据
        }
    }

    override fun onBindViewHolder(holder: BaseViewHolder, position: Int) {
        holder.onBind(position)
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BaseViewHolder {
        return when (viewType) {
            R.layout.item_merchant_history_header -> {
                val view = ItemMerchantHistoryHeaderBinding.inflate(LayoutInflater.from(parent.context))
                MerchantHistoryHeaderViewHolder(view)
            }
            R.layout.item_merchant_history -> {
                val view = ItemMerchantHistoryBinding.inflate(LayoutInflater.from(parent.context))
                MerchantHistoryViewHolder(view)
            }
            R.layout.item_network_state -> {
                val view = ItemNetworkStateBinding.inflate(LayoutInflater.from(parent.context))
                NetworkStateViewHolder(view)
            }
            else -> throw IllegalArgumentException("unknown view type $viewType")
        }
    }

    override fun getItemViewType(position: Int): Int {
        return when {
            position == 0 -> R.layout.item_merchant_history_header
            hasExtraRow() && position == itemCount - 1 -> R.layout.item_network_state
            position in 1..super.getItemCount() -> R.layout.item_merchant_history
            else -> throw IllegalArgumentException("unknown view type $position")
        }
    }

    private fun hasExtraRow() = networkState != NetworkState.LOADED

    override fun getItemCount(): Int {
        // 总项数 = 数据项数 + Header(1) + 可选NetworkState(1)
        return super.getItemCount() + 1 + if (hasExtraRow()) 1 else 0
    }

    fun setNetworkState(newNetworkState: NetworkState) {
        Timber.d("Setting network state....." + newNetworkState.status)
        val previousState = this.networkState
        val hadExtraRow = hasExtraRow()
        this.networkState = newNetworkState
        val hasExtraRow = hasExtraRow()
        if (hadExtraRow != hasExtraRow) {
            if (hadExtraRow) {
                notifyItemRemoved(super.getItemCount() + 1)
            } else {
                notifyItemInserted(super.getItemCount() + 1)
            }
        } else if (hasExtraRow && previousState != newNetworkState) {
            notifyItemChanged(itemCount - 1)
        }
    }

    inner class MerchantHistoryViewHolder(private val binding: ItemMerchantHistoryBinding) : BaseViewHolder(binding.root), MerchantHistoryItemViewModel.ListItemViewModelListener {
        private var itemViewModel: MerchantHistoryItemViewModel? = null

        override fun onBind(position: Int) {
            val transaction = getItem(position)
            transaction?.let {
                itemViewModel = MerchantHistoryItemViewModel(binding.root.context, it, this)
                binding.viewModel = itemViewModel
                binding.executePendingBindings()
            }
        }

        override fun onItemClick(item: MerchantHistoryResponse.Transaction) {
            listener.onItemClick(item)
        }
    }

    interface HistoryItemListAdapterListener {
        fun onItemClick(item: MerchantHistoryResponse.Transaction)
    }

    inner class NetworkStateViewHolder(private val binding: ItemNetworkStateBinding) : BaseViewHolder(binding.root), NetworkStateItemViewModel.ListItemViewModelListener {
        private var itemViewModel: NetworkStateItemViewModel? = null

        override fun onBind(position: Int) {
            Timber.d("binding position " + position + " with network state of " + networkState.status)
            itemViewModel = NetworkStateItemViewModel(binding.root.context, networkState,this)
            binding.viewModel = itemViewModel
            binding.executePendingBindings()
        }

        override fun onRetryClick() {
            networkStateListener.onRetryClick()
        }
    }

    interface NetworkStateListAdapterListener {
        fun onRetryClick()
    }

    inner class MerchantHistoryHeaderViewHolder(private val binding: ItemMerchantHistoryHeaderBinding) : BaseViewHolder(binding.root), MerchantHistoryHeaderItemViewModel.ListItemViewModelListener {
        private var itemViewModel: MerchantHistoryHeaderItemViewModel? = null

        override fun onBind(position: Int) {
            itemViewModel = MerchantHistoryHeaderItemViewModel(binding.root.context, this)
            binding.viewModel = itemViewModel
            binding.executePendingBindings()
        }

        override fun onItemClick() {
            headerListener.onItemClick()
        }
    }

    interface HistoryItemHeaderListAdapterListener {
        fun onItemClick()
    }

    class MerchantHistoryDiffUtilCallback : DiffUtil.ItemCallback<MerchantHistoryResponse.Transaction>() {
        override fun areItemsTheSame(oldItem: MerchantHistoryResponse.Transaction, newItem: MerchantHistoryResponse.Transaction): Boolean {
            return oldItem.uid == newItem.uid
        }

        override fun areContentsTheSame(oldItem: MerchantHistoryResponse.Transaction, newItem: MerchantHistoryResponse.Transaction): Boolean {
            return oldItem.uid == newItem.uid
        }
    }
}

关键修改点说明 #

1. 移除冗余的AsyncPagedListDiffer实例
   PagedListAdapter内部已经维护了一个AsyncPagedListDiffer，你手动创建的实例完全多余，还会破坏Adapter的数据同步逻辑。

2. 重写ListUpdateCallback处理位置偏移
   因为Header占据了第0位，所有数据项的位置都需要+1才能正确对应到Adapter的位置。通过包装原有的ListUpdateCallback，确保所有数据更新操作都自动偏移位置，这也解决了最初的滚动跳底部问题。

3. 修正ItemCount和GetItem逻辑

   • getItemCount()正确计算总项数：数据项数 + Header + 可选的NetworkState行
   • getItem()仅在数据项位置返回对应数据，Header和NetworkState位置返回null，避免越界

4. 修正NetworkState的通知位置
   NetworkState行的位置是super.getItemCount() + 1，确保在数据项之后、Header之外的正确位置。

5. 移除不必要的重写方法
   删除了submitList和getCurrentList的重写，直接使用PagedListAdapter的默认实现即可，默认实现已经正确处理了内部differ的提交和数据获取。

这样修改后，你的Adapter应该能正确显示Header、所有数据项和NetworkState行，同时不会出现滚动位置异常的问题。

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