RecyclerView Adapter的onBindViewHolder未触发问题求助

问题描述 #

RecyclerView的onBindViewHolder始终未执行，调试确认setPostList方法可正常进入，posts列表已成功加载15条数据，但onBindViewHolder从未被调用。尝试过在Fragment中手动调用notifyDataSetChanged()、注释部分UI绑定代码，均未解决问题。

相关Adapter代码 #

class PostAdapter: RecyclerView.Adapter<PostViewHolder>(){

    var posts = mutableListOf<PostModel>()

    fun setPostList(postResponseList: List<PostModel>){
        Log.i("PostAdapter", "setPostList")
        this.posts.clear()
        this.posts.addAll(postResponseList.toMutableList())
        this.notifyDataSetChanged()
        //imprimir la lista de post con un forEach
        posts.forEach { post -> Log.i("PostAdapter", post.toString()) }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): PostViewHolder {
        val inflater = LayoutInflater.from(parent.context)
        val binding = PostItemBinding.inflate(inflater, parent, false)

        return PostViewHolder(binding)
    }

    override fun onBindViewHolder(holder: PostViewHolder, position: Int) {
        try {

        Log.i("PostAdapter", "onBindViewHolder")
        val post = posts[position]
        holder.binding.petNameLabel.text = post.pet.name
        //imprimir el nombre del pet
        Log.i("PostAdapter", post.pet.name)

        holder.binding.aboutLabel.text = post.pet.about
        //imprimir el about del pet
        Log.i("PostAdapter", post.pet.about)

//        holder.binding.animalLabel.text = post.pet.animalType.name
//        //imprimir el tipo de animal
//        Log.i("PostAdapter", post.pet.animalType.name)
//
//        holder.binding.addresLabel.text = post.pet.address
//        //imprimir la dirección
//        Log.i("PostAdapter", post.pet.address)
//
//        holder.binding.breedLabel.text = post.pet.animalType.breed.name
//        //imprimir la raza
//        Log.i("PostAdapter", post.pet.animalType.breed.name)
//
//        holder.binding.ageLabel.text = post.pet.age.toString()
//        //imprimir la edad
//        Log.i("PostAdapter", post.pet.age.toString())
        
        } catch (e: Exception) {
            Log.i("PostAdapter", "Error en onBindViewHolder: ${e.message}")
        }
    }

    override fun getItemCount(): Int {
        return posts.size
    }

    companion object {
        const val POST_ID = "post_id"
    }
}

class PostViewHolder (
    val binding: PostItemBinding
) : RecyclerView.ViewHolder(binding.root)

排查与解决方案 #

• 检查RecyclerView的LayoutManager配置
  RecyclerView必须设置LayoutManager才能正常布局，可在XML中通过app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"指定，或在代码中手动设置：

  // Fragment中示例代码
  recyclerView.layoutManager = LinearLayoutManager(requireContext())
  

  未设置LayoutManager会导致RecyclerView无法计算视图位置，不会触发onBindViewHolder。

• 确认Adapter与RecyclerView的绑定关系
  检查代码中是否执行了recyclerView.adapter = postAdapter，避免因重复创建Adapter实例，导致数据更新到了未绑定到RecyclerView的Adapter对象上。

• 验证getItemCount返回值
  在setPostList方法末尾添加日志打印getItemCount()，确认返回值是否为15。若返回0，需检查posts列表的更新是否正确（比如是否存在线程安全问题，或数据转换错误）。

• 检查RecyclerView的可见性与布局尺寸
  确保RecyclerView的visibility为visible，且布局有足够的显示空间。例如父布局为ConstraintLayout时，需正确设置上下左右约束，避免RecyclerView因尺寸为0而无法显示。

• 确保notifyDataSetChanged在主线程调用
  数据更新通知必须在主线程执行，若setPostList是在子线程调用，需切换到主线程再执行notifyDataSetChanged()：

  // Fragment中主线程调用示例
  viewLifecycleOwner.lifecycleScope.launch(Dispatchers.Main) {
      postAdapter.notifyDataSetChanged()
  }
  

内容的提问来源于stack exchange，提问作者Andrés Fallas