Android开发中无更多扫描文件时如何停止Handler运行

你当前代码存在两个核心问题：一是每次定时任务触发都会从SD卡根目录重新递归扫描，无法记录上次扫描位置，会重复弹出第一个找到的mp3文件名；二是没有持有Handler和Runnable的全局实例，也没有遍历终止判断，无法主动停止任务循环。

正确实现步骤 #

• 将Handler、Runnable、待展示mp3文件列表、当前展示索引都定义为Activity/Fragment的成员变量，不要放在方法局部，否则停止任务时无法拿到对应实例
• 启动定时任务前先递归遍历一次外部存储，把所有后缀为.mp3的文件收集到列表里，避免每次定时触发都重复扫描存储
• 每次Runnable执行时先判断当前索引是否超过文件列表总长度：如果已经遍历完所有文件，直接移除Handler中待执行的回调，不再续接下一次延迟任务；如果还有未展示的文件，弹出对应Toast、索引自增后再post下一次延迟任务

修正后可直接运行的代码 #

// 类成员变量定义
private Handler mHandler;
private Runnable mShowToastRunnable;
private List<File> mMp3FileList = new ArrayList<>();
private int mCurrentShowIndex = 0;
private static final long TOAST_INTERVAL = 1000;

private void startShowMp3Name() {
    // 先收集所有mp3文件
    collectAllMp3(Environment.getExternalStorageDirectory());
    // 没有找到mp3直接返回
    if (mMp3FileList.isEmpty()) {
        Toast.makeText(this, "未找到任何mp3文件", Toast.LENGTH_SHORT).show();
        return;
    }
    mHandler = new Handler(Looper.getMainLooper());
    mShowToastRunnable = new Runnable() {
        @Override
        public void run() {
            // 所有文件已经展示完，停止任务
            if (mCurrentShowIndex >= mMp3FileList.size()) {
                stopHandlerTask();
                Toast.makeText(StartActivity.this, "所有mp3文件名已展示完毕", Toast.LENGTH_SHORT).show();
                return;
            }
            // 展示当前文件名
            File currentFile = mMp3FileList.get(mCurrentShowIndex);
            Toast.makeText(StartActivity.this, currentFile.getName(), Toast.LENGTH_SHORT).show();
            mCurrentShowIndex++;
            // 续接下一次任务
            mHandler.postDelayed(this, TOAST_INTERVAL);
        }
    };
    // 启动第一次任务
    mHandler.postDelayed(mShowToastRunnable, TOAST_INTERVAL);
}

// 递归收集所有mp3文件
private void collectAllMp3(File rootFile) {
    if (rootFile == null) return;
    File[] files = rootFile.listFiles();
    if (files == null) return;
    for (File file : files) {
        if (file.isDirectory()) {
            collectAllMp3(file);
        } else {
            if (file.getName().endsWith(".mp3")) {
                mMp3FileList.add(file);
            }
        }
    }
}

// 停止Handler任务的方法，页面销毁时也建议调用避免内存泄漏
private void stopHandlerTask() {
    if (mHandler != null && mShowToastRunnable != null) {
        mHandler.removeCallbacks(mShowToastRunnable);
    }
}

@Override
protected void onDestroy() {
    super.onDestroy();
    // 页面销毁时必须停止任务，防止内存泄漏
    stopHandlerTask();
}

关键停止逻辑说明 #

Handler循环任务的停止没有特殊API，核心只有两点：一是遍历到末尾时不再调用postDelayed续接下一次任务，二是调用removeCallbacks把消息队列里已经排队的待执行任务移除即可，任务就不会再继续运行。

额外注意事项 #

• Android 6.0及以上需要动态申请存储权限，Android 11及以上需要申请MANAGE_EXTERNAL_STORAGE权限才能正常读取外部存储的所有文件
• 不要在Runnable的run方法里做递归扫描文件的操作，IO操作放在主线程定时执行会造成卡顿，提前一次性收集完所有文件列表性能更好
• 页面销毁时必须调用停止方法，否则Handler持有Activity引用会造成内存泄漏

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