Android WebView打开指定文件夹HTML文件报错的解决方法

别着急，我来帮你一步步排查这个问题——这种情况大多和权限、路径适配或者系统存储规则有关，咱们挨个来解决：

1. 先确认文件权限是否配置正确 #

从Android 6.0（API 23）开始，读取外部存储需要动态申请权限，同时还要在清单文件里声明静态权限：

第一步：在AndroidManifest.xml中添加静态权限 #

<!-- 针对Android 12及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 针对Android 13+读取非媒体文件 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- Android 10（API 29）临时兼容分区存储的属性 -->
<application
    ...
    android:requestLegacyExternalStorage="true">
</application>

第二步：动态申请权限（在Activity中） #

在加载WebView之前，先检查并申请权限：

private static final int REQUEST_STORAGE_PERMISSION = 100;

// 检查权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED) {
    // 申请权限
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
            REQUEST_STORAGE_PERMISSION);
} else {
    // 权限已授予，加载HTML文件
    loadLocalHtml();
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            loadLocalHtml();
        } else {
            // 用户拒绝权限，提示无法加载文件
            Toast.makeText(this, "需要存储权限才能加载文件", Toast.LENGTH_SHORT).show();
        }
    }
}

// 加载HTML的方法
private void loadLocalHtml() {
    String filePath = Environment.getExternalStorageDirectory().getPath() + "/my_folder/index.html";
    htmlReaderPage_reader.loadUrl("file:///" + filePath);
}

2. 验证文件路径是否正确，且文件确实存在 #

有时候路径拼写错误或者文件根本没保存到目标位置，会导致加载失败。可以先打印路径并检查文件是否存在：

String filePath = Environment.getExternalStorageDirectory().getPath() + "/my_folder/index.html";
File htmlFile = new File(filePath);
Log.d("HTML_PATH", "文件路径：" + filePath);
Log.d("HTML_EXISTS", "文件是否存在：" + htmlFile.exists());

if (htmlFile.exists()) {
    htmlReaderPage_reader.loadUrl("file:///" + filePath);
} else {
    Toast.makeText(this, "文件不存在，请检查路径", Toast.LENGTH_SHORT).show();
}

注意：文件夹和文件名的大小写要完全匹配，Android的文件系统是区分大小写的。

3. 适配Android 10+的分区存储（Scoped Storage） #

从Android 10（API 29）开始，系统默认启用分区存储，直接访问外部存储根目录的自定义文件夹会受限：

• 如果你的目标SDK是29，可以在AndroidManifest.xml的application标签里添加android:requestLegacyExternalStorage="true"来兼容旧的存储方式（这个属性在API 30及以上会被忽略）。
• 如果目标SDK是30+（Android 11及以上），要么申请MANAGE_EXTERNAL_STORAGE权限（需要用户手动授权，且Google Play审核可能受限），要么把HTML文件存储到应用的专属外部目录（比如getExternalFilesDir(null)），这样不需要额外权限：

  // 应用专属外部目录路径，不需要权限
  String filePath = getExternalFilesDir(null).getPath() + "/my_folder/index.html";
  htmlReaderPage_reader.loadUrl("file:///" + filePath);
  

4. 检查WebView的关键设置 #

确保WebView允许访问本地文件：

htmlReaderPage_reader.getSettings().setAllowFileAccess(true);
htmlReaderPage_reader.getSettings().setAllowContentAccess(true);

这两个设置默认是开启的，但如果之前被修改过，会导致无法加载本地文件。

5. 查看Logcat定位具体错误 #

如果以上步骤都试过还是不行，打开Android Studio的Logcat，搜索WebView相关的日志，会看到具体的错误原因（比如FileNotFoundException或者PermissionDenied），这样能更精准地解决问题。

内容的提问来源于stack exchange，提问作者I'm Mr