Android无法访问XLSX文件：权限配置后仍报错求助

一、Assets文件夹文件访问问题 #

Assets是应用打包时自带的私有资源，根本不需要任何存储权限，提示权限问题大概率是代码错误或文件配置问题：

• 检查文件位置：确保xlsx文件放在src/main/assets目录下（子目录的话，路径要写相对路径，比如assets/data/test.xlsx就用"data/test.xlsx"访问）
• 文件名注意大小写：Android系统对assets文件名区分大小写，比如Test.xlsx和test.xlsx是两个不同文件
• 正确读取代码示例：

// 获取AssetManager实例
AssetManager assetManager = getApplicationContext().getAssets();
try {
    // 打开assets下的xlsx文件，直接写文件名（子目录加路径）
    InputStream is = assetManager.open("你的文件名.xlsx");
    // 这里用Excel解析库处理输入流，比如Apache POI
    // XSSFWorkbook workbook = new XSSFWorkbook(is);
    // 后续操作...
    is.close();
} catch (IOException e) {
    e.printStackTrace();
}

• 验证文件是否被打包：可以解压APK文件，查看assets目录下是否存在目标文件，确认打包过程没有遗漏。

二、外部存储文件访问问题 #

API 23+的权限逻辑在不同版本有差异，结合你的情况逐一排查：

1. 区分应用私有外部存储和公共存储
   • 如果是存储在应用私有外部目录（比如Android/data/你的包名/files/），直接用getExternalFilesDir(null)访问，不需要申请任何存储权限，代码示例：

     File privateDir = getExternalFilesDir(null);
     File xlsxFile = new File(privateDir, "test.xlsx");
     // 读取文件...
     

   • 如果是访问公共目录（比如Downloads、根目录），需要对应权限：
     • API 23-28：申请READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE运行时权限，且用户授予后才能访问
     • API 29-32：默认开启分区存储，要么在AndroidManifest.xml中添加android:requestLegacyExternalStorage="true"（仅API 29有效，API 30+逐步失效），要么改用MediaStore/SAF访问
     • API 33+：READ_EXTERNAL_STORAGE被废弃，访问媒体文件需要READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO权限；访问文档类文件（比如xlsx）需要使用**存储访问框架（SAF）**让用户选择文件，或者申请MANAGE_EXTERNAL_STORAGE特殊权限（需引导用户到设置开启）
2. 检查运行时权限申请逻辑
   确保权限申请流程正确，比如：

   // 检查权限是否已授予
   if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
           != PackageManager.PERMISSION_GRANTED) {
       // 申请权限
       ActivityCompat.requestPermissions(this,
               new String[]{Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE},
               1001);
   } else {
       // 权限已授予，执行文件访问操作
       accessExternalFile();
   }
   
   // 处理权限申请结果
   @Override
   public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
       super.onRequestPermissionsResult(requestCode, permissions, grantResults);
       if (requestCode == 1001) {
           if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
               // 权限授予成功
               accessExternalFile();
           } else {
               // 用户拒绝权限，提示引导
               Toast.makeText(this, "需要存储权限才能访问文件", Toast.LENGTH_SHORT).show();
           }
       }
   }
   

3. API 29+分区存储适配
   如果你的目标API是29及以上，尽量适配分区存储：
   • 访问公共目录的xlsx文件，推荐使用SAF让用户选择文件，示例代码：

     Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
     intent.setType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); // xlsx文件类型
     startActivityForResult(intent, 1002);
     

     然后在onActivityResult中获取Uri，通过ContentResolver访问文件：

     @Override
     protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
         super.onActivityResult(requestCode, resultCode, data);
         if (requestCode == 1002 && resultCode == RESULT_OK && data != null) {
             Uri uri = data.getData();
             try {
                 InputStream is = getContentResolver().openInputStream(uri);
                 // 处理输入流...
             } catch (IOException e) {
                 e.printStackTrace();
             }
         }
     }
     

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