使用File.listFiles()遍历含特殊字符文件的目录时App崩溃

我之前处理过类似的Android文件遍历异常，你的问题核心在于字符编码不匹配和旧版File API的局限性，下面一步步拆解原因和解决方案：

问题根源 #

1. adb推送的编码冲突：Windows系统默认字符编码和Android设备的UTF-8编码存在差异，你用adb push推送带Ñ、’这类特殊字符的文件时，命令行没有正确完成编码转换，导致设备端的文件名被截断或存储为乱码。这种异常文件名会让File.listFiles()在解析时触发未捕获的异常，直接导致App崩溃。
2. java.io.File的API局限性：旧版File类对非ASCII字符的支持不够健壮，遇到不符合预期的文件名（比如截断、乱码）时，很容易抛出异常且缺乏容错机制。

可行解决方案 #

1. 改用更健壮的NIO文件API（推荐） #

从Android 7.0（API 24）开始，官方推荐使用java.nio.file包下的API处理文件操作，它对字符编码的支持更完善，能更好地兼容特殊字符文件名。示例代码如下：

import java.nio.file.Files;
import java.nio.file.Paths;

// 遍历Music目录
try {
    Files.list(Paths.get("/sdcard/Music/"))
         .forEach(path -> {
             // 处理每个文件/目录
             String fileName = path.getFileName().toString();
             System.out.println("文件名：" + fileName);
         });
} catch (IOException e) {
    e.printStackTrace();
    // 添加友好的错误处理，避免App崩溃
}

如果需要兼容更低版本的Android，可以使用Apache Commons IO库中的FileUtils类，它同样对特殊字符有更好的处理能力。

2. 修复adb推送的编码问题 #

先确保文件名在设备端被正确存储：

• 在Windows命令提示符中先切换到UTF-8编码，再执行推送命令：

chcp 65001
adb push "My_file_Ñ_’_Special_chars.mp3" /sdcard/Music/

• 或者改用Android Studio的Device File Explorer推送文件，它会自动处理编码转换，避免命令行的编码歧义。

3. 临时异常捕获（应急方案） #

如果暂时无法替换API，可以在遍历文件时添加异常捕获，避免整个App崩溃：

File musicDir = new File("/sdcard/Music/");
File[] files = musicDir.listFiles();
if (files != null) {
    for (File file : files) {
        try {
            String fileName = file.getName();
            // 处理文件逻辑
        } catch (Exception e) {
            e.printStackTrace();
            // 跳过异常文件，继续遍历其他文件
        }
    }
}

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