Ionic 3应用Android 11下PDF及图片路径访问被拒绝问题求助

问题根因 #

Android 11（API 30）强制启用分区存储机制，应用私有沙箱目录的file://协议路径不允许直接被WebView加载，即使是应用自己生成的文件也会触发net::ERR_ACCESS_DENIED错误，和是否申请存储权限无关，完全不需要申请谷歌商店禁止的MANAGE_EXTERNAL_STORAGE高风险权限。

适配步骤 #

1. 调整AndroidManifest.xml配置 #

• 移除已经添加的MANAGE_EXTERNAL_STORAGE权限声明
• 保留基础存储权限，限制生效范围：

<!-- Android 13+ 不需要读外部存储权限访问自身沙箱 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />

• 无需添加requestLegacyExternalStorage遗留兼容标记，Android 11+该属性已失效

2. 配置WebView文件访问权限 #

在项目根目录的config.xml中，添加Android平台专属配置，放开WebView的文件访问限制：

<platform name="android">
  <preference name="AllowFileAccess" value="true" />
  <preference name="AllowUniversalAccessFromFileURLs" value="true" />
  <preference name="AllowFileAccessFromFileURLs" value="true" />
</platform>

3. 转换文件路径为WebView可访问格式 #

Ionic默认使用的cordova-plugin-ionic-webview插件自带路径转换能力，不需要硬写系统绝对路径：

• 不要直接使用file://开头的原始路径加载资源，调用Ionic.WebView.convertFileSrc()方法转换路径，示例代码：

// 入参为你获取到的原始file://路径，比如图片、PDF的存储路径
function getAccessiblePath(originalFilePath) {
  return window.Ionic.WebView.convertFileSrc(originalFilePath);
}

• 转换后的路径格式为http://localhost:8080/_file_/私有沙箱路径/xxx.png，WebView访问该路径不会触发权限拦截

4. 特殊场景适配 #

• 图片加载：转换后的路径直接赋值给img标签的src属性即可正常显示
• PDF加载：如果用iframe、webview或者pdf.js加载，直接传入转换后的HTTP格式路径即可，无需额外权限

5. 验证适配 #

卸载设备上已安装的旧版应用避免权限缓存，重新打包安装后即可在Android 11+系统正常加载沙箱内的图片和PDF资源，同时符合谷歌应用商店的权限审核要求。

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