如何在Android WebView中通过iframe直接访问SD卡本地HTML文件

核心问题分析 #

你遇到的崩溃本质是WebView本地文件访问限制+Android存储权限配置不全导致的：

• Android 6.0+需要动态申请读写存储权限，Android 10+的分区存储会进一步限制直接访问SD卡根目录；
• WebView默认禁用了file://跨文件访问（比如主页面加载另一个file路径的iframe），直接加载会触发安全限制导致崩溃。

步骤1：配置存储权限 #

1. 在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 11+ 需额外申请全存储访问权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

2. 动态申请权限（适配多版本）：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    // Android 11+ 检查全存储权限
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        Uri uri = Uri.fromParts("package", getPackageName(), null);
        intent.setData(uri);
        startActivityForResult(intent, 100);
    }
} else {
    // Android 6-9 动态申请读写权限
    String[] permissions = {Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE};
    if (ContextCompat.checkSelfPermission(this, permissions[0]) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, permissions, 100);
    }
}

步骤2：配置WebView允许本地文件访问 #

必须开启WebView的文件访问相关开关，否则file://路径的iframe会被拦截：

WebView webView = findViewById(R.id.webview);
WebSettings settings = webView.getSettings();

// 开启JavaScript支持（你的场景必须开启）
settings.setJavaScriptEnabled(true);
// 允许WebView访问文件系统
settings.setAllowFileAccess(true);
// 允许从file://页面加载其他file://资源（关键！默认是false）
settings.setAllowFileAccessFromFileURLs(true);
// 允许从file://页面加载content://资源（可选，适配更多场景）
settings.setAllowUniversalAccessFromFileURLs(true);

// 设置WebViewClient，避免跳转到系统浏览器
webView.setWebViewClient(new WebViewClient());

步骤3：正确使用iframe加载SD卡文件 #

完成上述配置后，直接使用file://路径加载iframe即可，注意路径要准确（比如文件在SD卡根目录下的test.html）：

<iframe src="file:///storage/emulated/0/test.html" width="100%" height="600px"></iframe>

如果仍有问题，可尝试通过loadDataWithBaseURL加载主页面，用相对路径指向SD卡文件：

// 主页面HTML内容，iframe用相对路径
String mainHtml = "<html><body><iframe src='test.html'></iframe></body></html>";
// 将baseURL设为SD卡根目录的file路径
webView.loadDataWithBaseURL("file:///storage/emulated/0/", mainHtml, "text/html", "UTF-8", null);

额外注意事项 #

• Android 13+有更细分的存储权限，若仅需访问特定类型文件，可使用READ_MEDIA_IMAGES等替代全存储权限；若要访问任意文件，仍需MANAGE_EXTERNAL_STORAGE；
• 避免开启setJavaScriptCanOpenWindowsAutomatically等危险设置，降低安全风险；
• 测试时确保SD卡中HTML文件路径准确，文件名尽量避免中文或特殊字符，防止编码问题。

内容的提问来源于stack exchange，提问作者Hit and Run