求助：Android WebView加载外部存储HTML页面的实现问题

别担心，我之前也碰到过类似的困扰，咱们一步步来搞定这个问题。要让WebView加载外部存储里的HTML，核心要搞定权限配置、文件路径处理和WebView的正确设置这三个关键点，下面详细说：

一、先搞定存储权限 #

外部存储的访问权限是前提，不同Android版本的处理方式略有区别：

1. 在AndroidManifest.xml里声明权限 #

<!-- 基础读写权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" /> <!-- Android 10+不需要WRITE权限了 -->

<!-- 如果是Android 10（API 29）及以上，暂时不想适配Scoped Storage的话，加上这个属性 -->
<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

2. Android 6.0+动态申请权限 #

从API 23开始，危险权限需要动态申请，在MainActivity里加这段代码：

private static final int REQUEST_STORAGE_PERMISSION = 100;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // 先检查权限
    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, "需要存储权限才能加载本地HTML", Toast.LENGTH_SHORT).show();
        }
    }
}

二、正确处理文件路径并加载HTML #

外部存储里的HTML文件路径要转成file:///开头的URL格式，注意路径的斜杠不要错。比如你的HTML文件在外部存储的Documents文件夹里，名叫test.html，路径就是/storage/emulated/0/Documents/test.html，对应的URL是file:///storage/emulated/0/Documents/test.html。

然后写loadLocalHtml()方法配置WebView：

private void loadLocalHtml() {
    WebView webView = findViewById(R.id.webview);

    // 配置WebView的设置
    WebSettings webSettings = webView.getSettings();
    webSettings.setJavaScriptEnabled(true); // 如果HTML里用到JS就开启，不用可以关掉
    webSettings.setAllowFileAccess(true); // 允许访问文件
    webSettings.setAllowFileAccessFromFileURLs(true); // 允许从文件URL加载其他文件（比如CSS、JS）
    webSettings.setAllowUniversalAccessFromFileURLs(true);

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

    // 替换成你自己的HTML文件路径
    String htmlPath = Environment.getExternalStorageDirectory() + "/Documents/test.html";
    Uri uri = Uri.fromFile(new File(htmlPath));
    webView.loadUrl(uri.toString());

    // 如果你用的是Android 10+的Scoped Storage，推荐用getExternalFilesDir()获取应用专属外部存储路径
    // String htmlPath = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS) + "/test.html";
}

三、注意事项 #

• 如果你加载的HTML里引用了本地的CSS、JS、图片等资源，要确保这些资源的路径是正确的，相对路径要和HTML文件的位置对应，或者用绝对路径。
• Android 11（API 30）及以上，requestLegacyExternalStorage属性会失效，如果要访问公共目录的文件，得用**存储访问框架（SAF）**让用户选择文件，不过如果只是加载应用专属外部存储里的文件，用getExternalFilesDir()就没问题，不需要额外权限。

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