本文详解 android 读取外部存储 csv 文件的完整实现，重点解决因存储权限变更（尤其是 android 10+ scoped storage）导致的文件读取失败问题，并提供适配 android 11 及以上的兼容方案。
本文详解 android 读取外部存储 csv 文件的完整实现，重点解决因存储权限变更（尤其是 android 10+ scoped storage）导致的文件读取失败问题，并提供适配 android 11 及以上的兼容方案。
在 Android 开发中，从外部存储（如 /sdcard/dl/m.csv）读取 CSV 文件看似简单，但自 Android 10（API 29）起，系统默认启用 Scoped Storage 机制，严格限制应用对共享外部存储的访问权限。若未正确配置，即使文件路径真实存在、代码逻辑无误，FileInputStream 仍会抛出 FileNotFoundException 或 SecurityException，导致读取失败——这正是您遇到的问题核心。
✅ 关键修复：适配 Android 10（API 29）的临时方案
您已成功通过在 AndroidManifest.xml 的
<application android:requestlegacyexternalstorage="true" ...></application>
该属性强制应用以旧版（Legacy）存储模式运行，恢复对 Environment.getExternalStorageDirectory() 的直接访问能力。⚠️ 注意：此方案仅适用于 targetSdkVersion ≤ 29 的应用；若您的 targetSdkVersion ≥ 30（即 Android 11+），该属性将被系统忽略，必须迁移到现代存储实践。
? 正确的读取流程与优化代码示例
以下为结构清晰、健壮性更强的 CSV 读取实现（基于 Java），已整合您的逻辑并修正关键隐患：
// 1. 声明必要权限（AndroidManifest.xml） <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission><!-- 若需写入或 Android 11+ 读取媒体文件，还需添加 --><uses-permission android:name="android.permission.READ_MEDIA_IMAGES"></uses-permission><uses-permission android:name="android.permission.READ_MEDIA_AUDIO"></uses-permission><uses-permission android:name="android.permission.READ_MEDIA_VIDEO"></uses-permission>
// 2. Java 读取逻辑（建议放在后台线程，如 AsyncTask / Thread / Coroutine）
private void readCsvFromExternalStorage() {
try {
// ✅ 安全获取目录（避免硬编码路径）
File sdCard = Environment.getExternalStorageDirectory();
File dir = new File(sdCard, "dl"); // 等价于 sdCard.getAbsolutePath() + "/dl"
File csvFile = new File(dir, "m.csv");
if (!csvFile.exists()) {
Log.e("CSV_READ", "CSV file not found: " + csvFile.getAbsolutePath());
return;
}
// ✅ 使用 try-with-resources 自动关闭流
StringBuilder result = new StringBuilder();
List<yourdataclass> weathersam = new ArrayList();
try (FileInputStream fis = new FileInputStream(csvFile);
BufferedReader reader = new BufferedReader(
new InputStreamReader(fis, StandardCharsets.UTF_8))) {
String line;
int lineNumber = 0;
while ((line = reader.readLine()) != null) {
lineNumber++;
// 跳过空行
if (line.trim().isEmpty()) continue;
String[] tokens = line.split(",", -1); // -1 保留末尾空字段
// ✅ 示例：构建数据对象（请替换 YourDataClass 为实际类）
YourDataClass dt = new YourDataClass();
for (int i = 0; i 0 && tokens[0].length() > 15) {
result.append(dt.gets2()).append("---\n");
} else {
result.append(tokens[0]).append("-\n");
}
weathersam.add(dt);
}
}
// ✅ 在主线程更新 UI（例如 TextView）
runOnUiThread(() -> {
tv.setText("Processed " + lineNumber + " lines.\n" + result.toString());
});
} catch (IOException e) {
Log.e("CSV_READ", "IO Error: ", e);
// 显示用户友好提示（如 Toast）
Toast.makeText(this, "读取失败: " + e.getMessage(), Toast.LENGTH_LONG).show();
} catch (SecurityException e) {
Log.e("CSV_READ", "Permission denied: ", e);
// 引导用户手动授权（尤其 Android 11+）
requestStoragePermission();
}
}</yourdataclass>
⚠️ 重要注意事项与升级建议
权限动态申请：自 Android 6.0（API 23）起，READ_EXTERNAL_STORAGE 属于危险权限，必须在运行时请求，不能仅依赖 Manifest 声明。使用 ActivityCompat.requestPermissions() 并处理回调。
Knowledge Graph - Csv Graph Loader Generator下载从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。
-
Android 11+（API 30+）强制要求：
- requestLegacyExternalStorage="true" 完全失效；
- 推荐使用 Storage Access Framework (SAF) 通过 Intent.ACTION_OPEN_DOCUMENT 让用户选择文件（最兼容）；
- 或使用 MediaStore API 访问照片/视频/音频；
- 对于应用专属目录（如 getExternalFilesDir()），无需权限即可读写。
编码与分隔符鲁棒性：CSV 可能含逗号、换行符或引号。生产环境建议使用 OpenCSV 或 Apache Commons CSV 库替代手动 split()。
性能与内存：大文件勿在主线程解析；避免频繁调用 TextView.setText()；使用 StringBuilder 拼接文本。
✅ 总结
当前问题本质是 Android 存储模型演进引发的权限适配问题。requestLegacyExternalStorage="true" 是快速验证方案，但长期应转向 SAF 或 MediaStore。确保权限声明、动态申请、异常处理三者完备，再辅以健壮的 CSV 解析逻辑，即可稳定读取外部 CSV 文件。
