将ProgressDialog设计为单例类是否合理？报错原因及解决方法

咱们一步步来拆解你遇到的这几个问题：

一、将ProgressDialog设计为单例类是否属于良好实践？ #

答案是否定的，这并不是一个好的实践，原因主要有三点：

• 生命周期不匹配：ProgressDialog是和Activity的UI生命周期强绑定的组件，单例模式会让它持有某个Activity的Context引用，当该Activity被销毁后，Dialog实例依然存在，不仅会导致内存泄漏，还会引发你遇到的WindowManager错误。
• 灵活性不足：不同页面的加载提示需求可能不一样（比如是否可取消、自定义样式等），单例模式很难适配这些差异化需求。
• 内存泄漏风险：单例的静态实例会持有Context的强引用，如果持有是Activity的Context，会导致Activity无法被GC回收，进而引发内存泄漏。

二、错误的原因是什么？ #

你遇到的android.view.WindowManager$BadTokenException错误，核心原因是单例持有的Context已经失效：

1. 当你在第一个Activity（比如ActivityA）中调用getInstance(this)时，单例初始化并持有了ActivityA的Context。
2. 当你跳转到第二个Activity（ActivityB）并再次调用getInstance(this)时，因为单例已经存在，不会重新创建，所以依然持有ActivityA的Context。
3. 如果此时ActivityA已经被系统销毁（比如用户按返回键，或者系统因内存不足回收了它），它的Context就变成了无效的BinderProxy，这时再调用showDialog，用这个失效的Context去创建/显示Dialog，WindowManager就会抛出错误，提示你“对应的Activity已经不在运行状态”。

三、如何解决这个问题？ #

这里给你几个可行的解决方案，按推荐程度排序：

方案1：使用DialogFragment替代ProgressDialog（最推荐） #

Android官方更推荐用DialogFragment来管理对话框，它的生命周期会和宿主Activity自动绑定，能避免很多生命周期不匹配的问题：

public class LoadingDialogFragment extends DialogFragment {
    private static final String ARG_MESSAGE = "message";

    // 创建实例的静态方法
    public static LoadingDialogFragment newInstance(String message) {
        LoadingDialogFragment fragment = new LoadingDialogFragment();
        Bundle args = new Bundle();
        args.putString(ARG_MESSAGE, message);
        fragment.setArguments(args);
        return fragment;
    }

    @NonNull
    @Override
    public Dialog onCreateDialog(@Nullable Bundle savedInstanceState) {
        ProgressDialog dialog = new ProgressDialog(requireContext());
        dialog.setMessage(getArguments().getString(ARG_MESSAGE));
        dialog.setCancelable(false); // 根据需求设置是否可取消
        return dialog;
    }
}

调用方式：

// 在Activity中显示对话框
LoadingDialogFragment loadingDialog = LoadingDialogFragment.newInstance("加载中...");
loadingDialog.show(getSupportFragmentManager(), "loading_dialog");

// 在需要关闭的地方调用
if (loadingDialog != null && loadingDialog.isVisible()) {
    loadingDialog.dismiss();
}

方案2：放弃单例，在每个Activity中独立管理ProgressDialog #

这种方式简单直接，每个Activity维护自己的Dialog实例，在生命周期方法中确保销毁：

public class YourActivity extends AppCompatActivity {
    private ProgressDialog pDialog;

    // 显示加载对话框
    public void showLoading(String msg) {
        if (pDialog == null) {
            pDialog = new ProgressDialog(this);
            pDialog.setCancelable(false);
        }
        pDialog.setMessage(msg);
        // 先判断Activity是否还在运行，避免报错
        if (!isFinishing()) {
            pDialog.show();
        }
    }

    // 关闭加载对话框
    public void hideLoading() {
        if (pDialog != null && pDialog.isShowing()) {
            pDialog.dismiss();
            pDialog = null; // 释放引用，避免内存泄漏
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        hideLoading(); // 销毁时确保关闭对话框
    }
}

方案3：修改单例类，用弱引用持有Context并动态更新 #

如果你坚持要用单例管理，可以用弱引用持有Context，并且每次显示Dialog时传入当前有效的Context：

public class ProgressDialogManager {
    private static ProgressDialogManager manager;
    private WeakReference<Context> contextRef;
    private ProgressDialog pDialog;

    private ProgressDialogManager() {} // 私有构造，不直接传入Context

    public static ProgressDialogManager getInstance() {
        if (manager == null) {
            manager = new ProgressDialogManager();
        }
        return manager;
    }

    public void showDialog(Context currentContext, String msg) {
        // 更新为当前Activity的弱引用
        contextRef = new WeakReference<>(currentContext);
        Context context = contextRef.get();
        
        // 检查Context是否有效
        if (context == null || ((Activity) context).isFinishing()) {
            return;
        }

        // 处理之前可能绑定了无效Context的Dialog
        if (pDialog != null) {
            try {
                pDialog.dismiss();
            } catch (Exception e) {
                // 捕获Dialog已绑定无效Context的异常
                e.printStackTrace();
            }
        }

        pDialog = new ProgressDialog(context);
        pDialog.setMessage(msg);
        if (!((Activity) context).isFinishing()) {
            pDialog.show();
        }
    }

    public void closeDialog() {
        if (pDialog != null && pDialog.isShowing()) {
            try {
                pDialog.dismiss();
            } catch (Exception e) {
                e.printStackTrace();
            }
            pDialog = null;
        }
    }
}

调用方式：

// 在Activity中显示
ProgressDialogManager.getInstance().showDialog(this, "加载中...");
// 在Activity销毁时调用
ProgressDialogManager.getInstance().closeDialog();

内容的提问来源于stack exchange，提问作者Faisal Bin Mohammad Ali