RecyclerView Inconsistency detected. Invalid item position异常原因及解决方案

• 引起异常的原因

java.lang.IndexOutOfBoundsException : Inconsistency detected. Invalid item position异常
字面意思即检测到不一致数据，一般情况下都是因为修改了适配器adapter的数据源而没有即时调用相应的notify方法造成的。比如有一个adapter的数据源是通过读取一个list来获取的，如果在某个地方调用了List.clear()方法清空数据，但这时没有即时调用notifyItemRangeRemoved()方法，之后又为了添加一些数据而调用了List.add()方法，而这时再在之后直接调用其他的notify方法，就会抛出该异常。这个异常比较坑爹的地方在于出现这种问题时只会在RecyclerView内部抛出异常，通俗的说，就是抛出的一大推异常中不会出现熟悉的“Cause by”告诉你在自己写的代码的那个地方抛出了异常，这个时候我们往往是懵逼的。下面是我实际应用场景中遇到的情况

1 android.support.v7.widget.RecyclerView$Recycler.getViewForPosition(RecyclerView.java:5011)
2 android.support.v7.widget.RecyclerView$Recycler.getViewForPosition(RecyclerView.java:4967)
3 android.support.v7.widget.LinearLayoutManager$LayoutState.next(LinearLayoutManager.java:2029)
4 android.support.v7.widget.LinearLayoutManager.layoutChunk(LinearLayoutManager.java:1414)
5 android.support.v7.widget.LinearLayoutManager.fill(LinearLayoutManager.java:1377)
6 android.support.v7.widget.LinearLayoutManager.onLayoutChildren(LinearLayoutManager.java:578)
7 android.support.v7.widget.RecyclerView.dispatchLayoutStep2(RecyclerView.java:3315)
8 android.support.v7.widget.RecyclerView.dispatchLayout(RecyclerView.java:3124)
9 android.support.v7.widget.RecyclerView.onLayout(RecyclerView.java:3568)
10 android.view.View.layout(View.java:16754)
11 android.view.ViewGroup.layout(ViewGroup.java:5462)
12 android.widget.LinearLayout.setChildFrame(LinearLayout.java:1764)
13 android.widget.LinearLayout.layoutVertical(LinearLayout.java:1607)
14 android.widget.LinearLayout.onLayout(LinearLayout.java:1516)
15 android.view.View.layout(View.java:16754)
16 android.view.ViewGroup.layout(ViewGroup.java:5462)
17 android.widget.FrameLayout.layoutChildren(FrameLayout.java:338)
18 android.widget.FrameLayout.onLayout(FrameLayout.java:273)
19 android.view.View.layout(View.java:16754)
20 android.view.ViewGroup.layout(ViewGroup.java:5462)
21 android.widget.LinearLayout.setChildFrame(LinearLayout.java:1764)
22 android.widget.LinearLayout.layoutVertical(LinearLayout.java:1607)
23 android.widget.LinearLayout.onLayout(LinearLayout.java:1516)
24 android.view.View.layout(View.java:16754)
25 android.view.ViewGroup.layout(ViewGroup.java:5462)
26 android.widget.FrameLayout.layoutChildren(FrameLayout.java:338)
27 android.widget.FrameLayout.onLayout(FrameLayout.java:273)
28 android.view.View.layout(View.java:16754)
29 android.view.ViewGroup.layout(ViewGroup.java:5462)
30 android.widget.LinearLayout.setChildFrame(LinearLayout.java:1764)
31 android.widget.LinearLayout.layoutVertical(LinearLayout.java:1607)
32 android.widget.LinearLayout.onLayout(LinearLayout.java:1516)
33 android.view.View.layout(View.java:16754)
34 android.view.ViewGroup.layout(ViewGroup.java:5462)
35 android.widget.FrameLayout.layoutChildren(FrameLayout.java:338)
36 android.widget.FrameLayout.onLayout(FrameLayout.java:273)
37 com.android.internal.policy.PhoneWindow$DecorView.onLayout(PhoneWindow.java:2748)
38 android.view.View.layout(View.java:16754)
39 android.view.ViewGroup.layout(ViewGroup.java:5462)
40 android.view.ViewRootImpl.performLayout(ViewRootImpl.java:2226)
41 android.view.ViewRootImpl.performTraversals(ViewRootImpl.java:1983)
42 android.view.ViewRootImpl.doTraversal(ViewRootImpl.java:1139)
43 android.view.ViewRootImpl$TraversalRunnable.run(ViewRootImpl.java:6238)
44 android.view.Choreographer$CallbackRecord.run(Choreographer.java:884)
45 android.view.Choreographer.doCallbacks(Choreographer.java:696)
46 android.view.Choreographer.doFrame(Choreographer.java:631)
47 android.view.Choreographer$FrameDisplayEventReceiver.run(Choreographer.java:870)
48 android.os.Handler.handleCallback(Handler.java:743)
49 android.os.Handler.dispatchMessage(Handler.java:95)
50 android.os.Looper.loop(Looper.java:150)
51 android.app.ActivityThread.main(ActivityThread.java:5546)
52 java.lang.reflect.Method.invoke(Native Method)
53 com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:794)
54 com.android.internal.os.ZygoteInit.main(ZygoteInit.java:684)

通常遇到这种情况直接是连看的欲望都没有的。

• 解决方案

废话不多说，主要的解决思路还是之前说的，这是由于数据不同步造成的。

1. 首先需要找到抛出异常的地方
   由于无法从抛出的异常中知道代码的逻辑在那出错，只能照之前说的先找到自己代码中对数据源进行过修改的地方，检查是否在数据源修改过之后调用了相应的notify方法。这里我是通过log输出标记定位到了出错的代码块。原因在于我使用RXJava时，数据源变化和adapter的notify方法调用不在用一个线程造成的。

//注：messageList为适配器显示的item实例list
Observable.create(new Observable.OnSubscribe() {
                        @Override
                        public void call(Subscriber subscriber) {
                            ...
                            messageList.clear();
                            ...
                            subscriber.onNext("");
                        }
                    }).subscribeOn(Schedulers.io())
                            .observeOn(AndroidSchedulers.mainThread())
                            .subscribe(new Subscriber() {
                                @Override
                                public void onCompleted() {
                                }

                                @Override
                                public void onError(Throwable e) {
                                }

                                @Override
                                public void onNext(String s) {
                                    ...
                                    msgAdapter.notifyItemRangeRemoved(0, itemCount);
                                    ...
                                }
                            });

2. 问题原因
   这里简单说一下代码逻辑，就是在IO线程中执耗时行业务逻辑，调用了list的clear()方法，而之后在UI线程中才调用了notifyItemRangeRemoved()方法。这里看似没有问题，但是因为list的clear()方法调用是异步的，这意味着list这时可能不仅仅执行了clear()方法，还可能执行了其他操作，而之后再来执行notifyItemRangeRemoved()方法就产生了这个异常，因为当你通知适配器有多个数据插入时，这时的list的实际数据很可能已经不再与这个逻辑处理后的list匹配了。
3. 解决办法
   这里将数据源操作与适配器操作写在同一线程中，保证list调用clear()方法后立即执行notifyItemRangeRemoved()就解决问题了。

@Override
 public void onNext(String s) {
 ...
  int itemCount = messageList.size();
  messageList.clear();
   msgAdapter.notifyItemRangeRemoved(0, itemCount);
    ...
   }

• 问题总结

其实这个问题解决起来很简单，就是保证数据源和适配器修改后保持数据一致就行。但是往往很多时候我们并没有意识到自己违背了这一原则，尤其是在引入多线程之后。
另外，使用recyclerView的时候，进行数据刷新的时候作尽量不要直接使用notifyDataChanged()，而是使用相应的局部刷新方法。