为什么给RecyclerView设置setOnClickListener后无法触发点击事件？

问题根因 #

RecyclerView本身的OnClickListener默认不会触发，因为RecyclerView的触摸事件会优先分发给内部的子Item View，只要子Item消费了触摸事件（默认可交互的Item都会消费），父RecyclerView就收不到完整的点击事件流，自然不会回调onClick方法。

额外排查点：你提供的代码中，设置LayoutManager时用的是binding.list.recyclerview，后续设置点击事件、Adapter用的是binding.recyclerview，如果两个变量指向的不是同一个RecyclerView实例，也会导致你设置的点击事件完全不生效，请先确认引用的是同一个控件。

场景1：需要监听RecyclerView空白区域（无Item覆盖的区域）的点击

可以通过SimpleOnItemTouchListener配合手势检测实现，判断点击位置没有对应子Item时触发逻辑：

binding.recyclerview.addOnItemTouchListener(new RecyclerView.SimpleOnItemTouchListener() {
    private final GestureDetectorCompat gestureDetector = new GestureDetectorCompat(getContext(), new GestureDetector.SimpleOnGestureListener() {
        @Override
        public boolean onSingleTapUp(MotionEvent e) {
            // 查找点击位置对应的子Item
            View child = binding.recyclerview.findChildViewUnder(e.getX(), e.getY());
            // 没有找到子Item说明点击的是空白区域
            if (child == null) {
                Log.d("log", "Clicked");
                return true;
            }
            return false;
        }
    });

    @Override
    public boolean onInterceptTouchEvent(@NonNull RecyclerView rv, @NonNull MotionEvent e) {
        return gestureDetector.onTouchEvent(e);
    }
});

场景2：需要监听RecyclerView内子Item的点击

这是绝大多数场景下的真实需求，不能直接给RecyclerView全局设置点击，需要在Adapter中给每个Item的根布局设置点击事件：

1. 首先在自定义Adapter中定义点击回调接口

public class CustomAdapter extends RecyclerView.Adapter<CustomAdapter.ViewHolder> {
    private OnItemClickListener mListener;

    // 点击回调接口
    public interface OnItemClickListener {
        void onItemClick(int position);
    }

    // 对外暴露设置监听的方法
    public void setOnItemClickListener(OnItemClickListener listener) {
        mListener = listener;
    }

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_layout, parent, false);
        ViewHolder holder = new ViewHolder(itemView);
        // 给Item根布局设置点击事件
        itemView.setOnClickListener(v -> {
            if (mListener != null) {
                int position = holder.getAdapterPosition();
                // 过滤无效位置，避免ViewHolder回收后触发异常
                if (position != RecyclerView.NO_POSITION) {
                    mListener.onItemClick(position);
                }
            }
        });
        return holder;
    }

    // 其他Adapter原有逻辑省略...

    static class ViewHolder extends RecyclerView.ViewHolder {
        ViewHolder(@NonNull View itemView) {
            super(itemView);
            // 绑定Item内控件逻辑省略...
        }
    }
}

2. 在Fragment中设置Item点击监听即可

adapter.setOnItemClickListener(position -> {
    Log.d("log", "点击了第" + position + "个Item");
    // 处理对应业务逻辑
});

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