Android读取/Documents目录xlsx文件遇EACCES权限拒绝问题求助

核心原因排查 #

你的问题大概率是Android 10+的分区存储机制导致的——即使申请了传统存储权限，直接访问公共Documents目录下的文件也会被系统限制，另外也可能存在权限申请不彻底或文件属性异常的情况。以下是针对性解决方案：

1. 适配分区存储（优先推荐） #

Android 10（API 29）及以上引入分区存储，禁止应用直接通过路径访问公共目录文件，建议使用**存储访问框架（SAF）**让用户手动选择文件，通过ContentResolver读取：

// 定义请求码
private static final int REQUEST_PICK_EXCEL = 1001;

// 启动文件选择器，仅筛选xlsx文件
private void pickExcelFile() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    // 指定xlsx文件MIME类型
    intent.setType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    startActivityForResult(intent, REQUEST_PICK_EXCEL);
}

// 处理选择结果
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_PICK_EXCEL && resultCode == RESULT_OK && data != null) {
        Uri fileUri = data.getData();
        try (InputStream inputStream = getContentResolver().openInputStream(fileUri)) {
            // 在这里使用inputStream读取Excel内容（比如传给POI等解析库）
            loadExcelFromStream(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

// 封装的Excel读取方法
private void loadExcelFromStream(InputStream inputStream) {
    // 你的Excel解析逻辑
}

2. 临时兼容旧存储模式（仅作过渡方案） #

如果需要快速验证功能，可以在AndroidManifest.xml的<application>标签中添加以下属性，暂时绕过分区存储限制：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

注意：该属性在Android 11（API 30）及以上部分场景失效，且不符合Google的存储规范，不建议长期使用。

3. 确认权限申请的有效性 #

即使调用了verifyStoragePermissions，也要确保运行时权限真正被用户授予：

// 检查并申请读取权限
private void checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                1002);
    } else {
        // 权限已授予，尝试读取文件（仅适配Android 9及以下或开启legacy模式的情况）
        attemptLoadExcel();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1002 && grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
        attemptLoadExcel();
    }
}

// 传统路径读取方法（仅在兼容模式下有效）
private void attemptLoadExcel() {
    File documentsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
    File excelFile = new File(documentsDir, "test.xlsx");
    if (excelFile.exists()) {
        try (FileInputStream fis = new FileInputStream(excelFile)) {
            // 读取逻辑
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

另外，Android 11及以上无需申请WRITE_EXTERNAL_STORAGE，该权限已被废弃。

4. 检查文件权限属性 #

通过adb命令查看文件的权限配置，确认是否允许应用访问：

adb shell ls -l /storage/emulated/0/Documents/test.xlsx

如果文件权限为-rw-------，说明仅文件所有者可读写，应用无法直接访问，建议让用户重新复制文件到Documents目录，或通过SAF方式读取。

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