DialogFragment 崩溃异常 IllegalStateException:Can not perform this action after onSaveInstanceState

崩溃堆栈信息

Caused by: java.lang.IllegalStateException:Can not perform this action after onSaveInstanceState
at android.support.v4.app.FragmentManagerImpl.checkStateLoss(FragmentManager.java:2080)
at android.support.v4.app.FragmentManagerImpl.enqueueAction(FragmentManager.java:2106)
at android.support.v4.app.BackStackRecord.commitInternal(BackStackRecord.java:683)
at android.support.v4.app.BackStackRecord.commit(BackStackRecord.java:637)
at android.support.v4.app.DialogFragment.dismissInternal(DialogFragment.java:224)
at android.support.v4.app.DialogFragment.dismiss(DialogFragment.java:191)
at com.xxx.BaseActivity.dismissLoading(BaseActivity.java:170)

可以看到是在 onSaveInstanceState 之后操作了 DialogFragment。
那么什么场景下会触发 onSaveInstanceState 呢？

触发 onSaveInstanceState 的场景

用户主动销毁 Activity 时，不会触发 onSaveInstanceState。有可能被动销毁 Activity 时，才会触发 onSaveInstanceState 来保存一些信息，等下次打开这个 Activity 时恢复这些信息。什么是被动销毁呢？比如说用户按了 HOME 键，去打开其他的 App 了，那么 Activity 随时可能被系统杀死，被系统杀死就叫做被动销毁。

触发 onSaveInstanceState 的场景有以下几种：

用户按了 HOME 键
用户调出任务管理
屏幕熄掉
横竖屏切换

从源码角度分析为什么 DialogFragment 的 show 和 dismiss 不能在 onSaveInstanceState 之后

首先看下 DialogFragment 的 show 方法

public void show(FragmentManager manager, String tag) {
    this.mDismissed = false;
    this.mShownByMe = true;
    FragmentTransaction ft = manager.beginTransaction();
    ft.add(this, tag);
    ft.commit();
}

FragmentManager 是调用 show 方法时传进来的 getSupportFragmentManager()，getSupportFragmentManager 返回的是 FragmentManagerImpl，FragmentManagerImpl 的 beginTransaction 返回的是 BackStackRecord。

也就是说最后是调用 BackStackRecord 的 commit 方法。

我们来看一下 commit 方法的源代码。

public int commit() {
    return this.commitInternal(false);
}

int commitInternal(boolean allowStateLoss) {
    if (this.mCommitted) {
        throw new IllegalStateException("commit already called");
    } else {
        // 此处省略不相干代码
        this.mManager.enqueueAction(this, allowStateLoss);
        return this.mIndex;
    }
}

接着调用 FragmentManagerImpl 的 enqueueAction 方法

    public void enqueueAction(FragmentManagerImpl.OpGenerator action, boolean allowStateLoss) {
        if (!allowStateLoss) {
            this.checkStateLoss();
        }

        synchronized(this) {
            if (!this.mDestroyed && this.mHost != null) {
                if (this.mPendingActions == null) {
                    this.mPendingActions = new ArrayList();
                }

                this.mPendingActions.add(action);
                this.scheduleCommit();
            } else if (!allowStateLoss) {
                throw new IllegalStateException("Activity has been destroyed");
            }
        }
    }

可以看到，如果 allowStateLoss 为 false 的话，就需要 checkStateLoss 了。前面 commit 方法里面传进来的正是 false。

再来看看 checkStateLoss 方法。

private void checkStateLoss() {
    if (this.isStateSaved()) {
        throw new IllegalStateException("Can not perform this action after onSaveInstanceState");
    } else if (this.mNoTransactionsBecause != null) {
        throw new IllegalStateException("Can not perform this action inside of " + this.mNoTransactionsBecause);
    }
}

public boolean isStateSaved() {
    return this.mStateSaved || this.mStopped;
}

可以看出如果 mStateSaved 是 true 的话，就会抛出文章开头提到的异常。
那么 mStateSaved 是不是 onSaveInstanceState 之后就变成 true 了呢？

我么接着看 onSaveInstanceState 的源代码

protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    this.markFragmentsCreated();
    Parcelable p = this.mFragments.saveAllState();
    // 省略不相干代码
}

public Parcelable saveAllState() {
    return this.mHost.mFragmentManager.saveAllState();
}

Parcelable saveAllState() {
    // 省略不相干代码
    this.mStateSaved = true;
    // 省略不相干代码
}

可以看到 onSaveInstanceState 被调用之后，mStateSaved 就变成了 true。

致此，整个过程就明朗了，只要 onSaveInstanceState 被调用之后，再调用 DialogFragment 的 show 方法，就会抛出异常。
※ 注意：onSaveInstanceState 的生命周期在 onPause 或者 onStop 之后，不是固定的。

我们分析了 show 方法的源码，同理，dismiss 也可以照葫芦画瓢，这边就不再描述了。

如何避免呢？

其实从源码可以看出，如果 allowStateLoss 为 true 的话，就不会抛出异常了。

除了 commit 方法，还有一个 commitAllowingStateLoss 方法，传的 allowStateLoss 正是 true。

But。。。我们只可以调用 show 方法，show 方法只能调用 commit，没有机会去调用 commit 方法。
show 方法不可以，dismiss 倒是可以直接调用 dismissAllowingStateLoss。

不懂 Google 为什么只设计了 dismissAllowingStateLoss 而没有设计 showAllowingStateLoss。

如果要让 show 方法也达到同样的效果，可以在自定义的 DialogFragment 中覆写 show 方法，然后把 commit 修改为 commitAllowingStateLoss，但是发现 mDismissed 和 mShownByMe 这两个变量的修饰符是 default，不是同一个 package，是访问不了的，可以在自己项目中新建和 android.support.v4.app 同样的 package 就可以了。

还有一种方法就是 try catch。这种方法虽然可以避免抛出异常，但是对话框是弹不出来了。

try {
    mDialogFragment.show(getSupportFragmentManager(), getClass().getName());
} catch (Exception e) {
    // 容错，不做任何处理
}

还有一种办法，如果操作 DialogFragment 的时候，onSaveInstanceState 已经被调用过了，那么先把操作保存起来，等页面显示的时候再执行。

首先新建一个 PausedAction 的类用来保存操作。

public class PausedAction {

    private ActionCallback mCallback;

    public void pause(boolean shouldPause, ActionCallback callback) {
        if (shouldPause) {
            this.mCallback = callback;
        } else {
            callback.call();
        }
    }

    public void resume() {
        if (mCallback != null) {
            mCallback.call();
            mCallback = null;
        }
    }

    public interface ActionCallback {
        void call();
    }
}

在操作 DialogFragment 的时候，根据 mStateSaved 的值，判断直接执行还是先保存起来

mPausedAction.pause(getSupportFragmentManager().isStateSaved(), 
    () -> mDialogFragment.show(getSupportFragmentManager(), getClass().getName()));

然后在页面可见的时候再执行

@Override
public void onResume() {
    super.onResume();
    mPausedAction.resume();
}