Android读取SD卡XML文件失败，求助解决方案

一、先解决权限未授予的核心问题 #

1. 补全权限申请的回调逻辑
   很多人只在onCreate里发起权限申请，却没等用户授权就直接调用createSwitchList()——这时候权限还没真正生效。必须在onRequestPermissionsResult回调里确认权限被授予后，再执行SD卡文件读取操作：

   @Override
   public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
       super.onRequestPermissionsResult(requestCode, permissions, grantResults);
       if (requestCode == YOUR_PERMISSION_REQUEST_CODE) {
           if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
               // 权限授予成功，调用解析方法
               createSwitchList();
           } else {
               // 权限被拒绝， fallback到读取字符串资源
               loadFromResource();
           }
       }
   }
   

   同时要确保发起申请前先检查权限状态：

   if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
       ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, YOUR_PERMISSION_REQUEST_CODE);
   } else {
       createSwitchList();
   }
   

2. 适配Android 11+的存储机制
   针对API 30及以上版本，仅加READ_EXTERNAL_STORAGE权限不够，需要在AndroidManifest.xml的<application>标签里添加：

   android:requestLegacyExternalStorage="true"
   

   绕过Scoped Storage的限制，才能直接访问SD卡根目录的文件。

3. 检查权限声明的正确性
   确认AndroidManifest.xml里的权限拼写无误：

   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   

   如果你的目标SDK是33及以上，READ_EXTERNAL_STORAGE已被废弃，但读取普通XML文件仍可保留该权限，不过要注意部分Android 13+设备的权限弹窗逻辑。

二、解决MalformedURLException异常 #

这个异常大概率是你用URL类解析本地文件路径导致的——本地文件没必要走URL协议，直接用File对象解析即可：

• 错误写法（会触发URL格式异常）：

  URL xmlUrl = new URL("file://" + sdCardPath + "/switch.xml");
  Document doc = DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(xmlUrl.openStream());
  

• 正确写法：

  File xmlFile = new File(Environment.getExternalStorageDirectory(), "switch.xml");
  if (xmlFile.exists()) {
      Document doc = DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(xmlFile);
      // 解析逻辑
  } else {
      loadFromResource();
  }
  

三、SD卡路径的正确获取 #

不要硬编码SD卡路径，用系统API保证兼容性：

if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
    File sdCardDir = Environment.getExternalStorageDirectory();
    File xmlFile = new File(sdCardDir, "switch.xml");
    // 后续操作
}

四、调试小技巧 #

• 在createSwitchList()开头加日志，确认权限状态：

  int permissionStatus = ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE);
  Log.d("Debug", "权限状态：" + (permissionStatus == PackageManager.PERMISSION_GRANTED ? "已授予" : "未授予"));
  

• 打印SD卡文件的完整路径，排查是否是路径拼写错误导致文件找不到。

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