获取含指定格式图片的文件夹列表时出现java.lang.IllegalStateException异常的求助

首先咱们来拆解一下你遇到的问题，这个异常的核心是UI线程的消息队列里，ViewRootImpl尝试移除一个不存在的同步屏障令牌，通常和UI生命周期变化、后台任务逻辑效率低、内存泄漏这几个点有关。我帮你一步步分析原因，再给出具体的解决方案：

一、异常根本原因分析 #

1. 后台任务运行时间过长：你的文件遍历逻辑用了ArrayList的contains方法（O(n)复杂度），加上递归遍历文件夹的方式，当设备存储里文件夹/文件很多时，后台线程会跑很久。这段时间里如果用户切换页面、旋转屏幕触发Activity重建，或者Activity进入销毁流程，后续通过handler.post执行的UI操作就会触发ViewRootImpl的异常状态——因为此时原有的UI根节点已经失效了。
2. 强引用导致的内存泄漏：你的LoadImageListener或Handler如果持有Activity的强引用，即使Activity已经销毁，后台任务还会继续执行并尝试更新UI，这会干扰UI线程的消息队列同步屏障逻辑，最终抛出这个异常。
3. 潜在的UI线程冲突：后台任务一开始就handler.post(listener::onStart)，如果onStart里做了复杂的UI操作（比如频繁请求布局），可能会和主线程的Choreographer帧同步逻辑冲突，导致同步屏障的添加/移除出现异常。

二、具体解决方案 #

1. 优化文件遍历逻辑，缩短后台任务耗时 #

这是最基础的优化，能从根源减少生命周期变化带来的风险：

• 把usedPaths从ArrayList改成HashSet，contains操作从O(n)降到O(1)：

  HashSet<String> usedPaths = new HashSet<>();
  

• 修复getListDir的冗余代码，同时处理listFiles返回null的情况（避免空指针）：

  public static ArrayList<String> getListDir(String path) {
      ArrayList<String> listFiles = new ArrayList<>();
      File dir = new File(path);
      File[] files = dir.listFiles();
      if (files == null) { // 无权限或不是目录时返回空列表
          return listFiles;
      }
      for (File file : files) {
          listFiles.add(file.getAbsolutePath());
      }
      return listFiles;
  }
  

• 优化checkFormat，支持大小写后缀（比如.PNG、.WEBP）：

  public static boolean checkFormat(String file) {
      String lowerName = file.toLowerCase();
      return lowerName.endsWith(".png") 
          || lowerName.endsWith(".jpg") 
          || lowerName.endsWith(".jpeg") 
          || lowerName.endsWith(".webp");
  }
  

2. 用弱引用避免内存泄漏，检查UI状态 #

给LoadImageListener套上WeakReference，确保Activity销毁后不会被后台任务持有引用；同时在post UI操作前检查Activity是否活跃：

public static void loadPaths(String path, LoadImageListener listener, Handler handler, AtomicBoolean isActivityAlive) {
    WeakReference<LoadImageListener> weakListener = new WeakReference<>(listener);
    
    new Thread() {
        @Override
        public void run() {
            // 检查Activity是否还活跃
            if (!isActivityAlive.get()) {
                return;
            }
            LoadImageListener currentListener = weakListener.get();
            if (currentListener != null) {
                handler.post(currentListener::onStart);
            }

            ArrayList<String> paths = new ArrayList<>();
            HashSet<String> usedPaths = new HashSet<>();
            ArrayList<GalleryObject> galleryObjects = new ArrayList<>();
            paths.add(path);

            for(int i = 0; i < paths.size() && isActivityAlive.get(); i++) {
                String filePath = paths.get(i);
                ArrayList<String> files = new ArrayList<>(getListDir(filePath));
                if(!files.contains(filePath + "/.nomedia"))
                    for(String stringFiles : files) {
                        File file = new File(stringFiles);
                        if(!file.getName().startsWith("."))
                            if(file.isDirectory())
                                paths.add(file.getAbsolutePath());
                            else if(checkFormat(file.getName()) && usedPaths.add(filePath)) {
                                GalleryObject galleryObject = new GalleryObject(file.getAbsolutePath(), true);
                                galleryObjects.add(galleryObject);
                            }
                    }
            }

            // 再次检查Activity状态
            if (isActivityAlive.get()) {
                handler.post(() -> {
                    LoadImageListener finishListener = weakListener.get();
                    if (finishListener != null) {
                        finishListener.onFinish(galleryObjects);
                    }
                });
            }
        }
    }.start();
}

然后在你的Activity里添加一个AtomicBoolean，在生命周期方法里更新状态：

private AtomicBoolean isActivityAlive = new AtomicBoolean(true);

@Override
protected void onDestroy() {
    super.onDestroy();
    isActivityAlive.set(false);
}

3. 用更安全的异步框架替代Thread+Handler #

如果你的项目支持，可以用Coroutines（Kotlin）或RxJava（Java）来处理异步任务，它们自带生命周期绑定能力，能自动在Activity销毁时取消任务：
比如用Kotlin Coroutines的写法（Java可以用RxJava的Disposable）：

// 在Activity中使用lifecycleScope自动绑定生命周期
lifecycleScope.launch(Dispatchers.IO) {
    val galleryObjects = loadGalleryObjects("/storage/emulated/0/")
    withContext(Dispatchers.Main) {
        if (!isDestroyed) {
            GalleryActivity.galleryObjects.clear()
            GalleryActivity.galleryObjects.addAll(galleryObjects)
            startActivity(Intent(this@HomeActivity, GalleryActivity::class.java))
        }
    }
}

private suspend fun loadGalleryObjects(rootPath: String): List<GalleryObject> {
    val paths = mutableListOf(rootPath)
    val usedPaths = mutableSetOf<String>()
    val galleryObjects = mutableListOf<GalleryObject>()
    var index = 0
    while (index < paths.size) {
        val filePath = paths[index]
        index++
        val files = getListDir(filePath)
        if (!files.contains("$filePath/.nomedia")) {
            for (stringFile in files) {
                val file = File(stringFile)
                if (!file.name.startsWith(".")) {
                    if (file.isDirectory) {
                        paths.add(file.absolutePath)
                    } else if (checkFormat(file.name) && usedPaths.add(filePath)) {
                        galleryObjects.add(GalleryObject(file.absolutePath, true))
                    }
                }
            }
        }
    }
    return galleryObjects
}

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