Android WebView应用无法访问相册文件问题求助

我来帮你排查这个问题，你遇到的WebView无法调用相册选择图片的情况，主要是几个关键环节没处理到位，咱们一步步来修复：

1. 核心问题：WebChromeClient未处理文件选择回调 #

默认的WebChromeClient不会响应网页中<input type="file">的文件选择请求，必须重写onShowFileChooser方法，把网页的文件选择请求转发给系统的文件选择器。

把你代码里的myWebView.setWebChromeClient(new WebChromeClient());替换成以下代码：

myWebView.setWebChromeClient(new WebChromeClient() {
    // 处理文件选择请求
    @Override
    public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
        // 保存回调，用于选择图片后返回结果
        MainActivity.this.mFilePathCallback = filePathCallback;
        
        // 打开系统文件选择器，指定选择图片
        Intent intent = fileChooserParams.createIntent();
        try {
            startActivityForResult(intent, FILE_CHOOSER_REQUEST_CODE);
        } catch (ActivityNotFoundException e) {
            mFilePathCallback = null;
            Toast.makeText(MainActivity.this, "无法打开文件选择器", Toast.LENGTH_SHORT).show();
            return false;
        }
        return true;
    }
});

同时，需要在MainActivity里添加对应的成员变量和常量，以及处理返回结果的方法：

// 定义常量和成员变量
private static final int FILE_CHOOSER_REQUEST_CODE = 1001;
private ValueCallback<Uri[]> mFilePathCallback;

// 处理文件选择返回结果
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == FILE_CHOOSER_REQUEST_CODE) {
        Uri[] results = null;
        // 判断选择是否成功
        if (resultCode == RESULT_OK) {
            if (data != null) {
                String dataString = data.getDataString();
                ClipData clipData = data.getClipData();
                
                if (clipData != null) {
                    results = new Uri[clipData.getItemCount()];
                    for (int i = 0; i < clipData.getItemCount(); i++) {
                        ClipData.Item item = clipData.getItemAt(i);
                        results[i] = item.getUri();
                    }
                } else if (dataString != null) {
                    results = new Uri[]{Uri.parse(dataString)};
                }
            }
        }
        // 把结果返回给WebView
        if (mFilePathCallback != null) {
            mFilePathCallback.onReceiveValue(results);
            mFilePathCallback = null;
        }
    }
}

2. 动态申请文件访问权限 #

Android 6.0（API 23）及以上版本，READ_EXTERNAL_STORAGE属于危险权限，只在Manifest里声明是不够的，必须在运行时动态申请。

在MainActivity的onCreate方法开头添加权限检查逻辑：

// 检查并申请文件访问权限
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1002);
    }
}

同时重写权限申请结果的处理方法：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1002) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限申请成功
        } else {
            Toast.makeText(this, "需要文件访问权限才能选择图片", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 修正Manifest配置问题 #

你的Manifest里有一些冗余或错误的配置，建议修改为：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example">
    <uses-permission android:name="android.permission.INTERNET"/>
    <!-- 只保留必要的文件权限 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- Android 10+ 适配分区存储，如果你还没适配Scoped Storage，添加这个属性 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
    
    <!-- 位置权限只保留标准的两个即可，其他非标准权限可以删除 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

    <application 
        android:allowBackup="true" 
        android:icon="@mipmap/ic_launcher" 
        android:label="label" 
        android:roundIcon="@mipmap/ic_launcher_round" 
        android:supportsRtl="true" 
        android:theme="@style/AppTheme" 
        android:usesCleartextTraffic="true" 
        android:hardwareAccelerated="true"
        <!-- Android 10+ 兼容旧的文件访问方式 -->
        android:requestLegacyExternalStorage="true">
        
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

说明：

• 去掉了重复的权限声明，比如重复的READ_EXTERNAL_STORAGE
• 删除了非标准权限WRITE_INTERNAL_STORAGE、ACCESS_GPS等
• 给WRITE_EXTERNAL_STORAGE添加了maxSdkVersion="28"，因为Android 10+不需要这个权限（如果用了requestLegacyExternalStorage的话）
• 添加android:requestLegacyExternalStorage="true"来兼容Android 10+的文件访问

4. 清理WebSettings冗余配置 #

你的代码里重复设置了setAllowFileAccess(true)，可以合并成一次；另外setAllowFileAccessFromFileURLs和setAllowUniversalAccessFromFileURLs如果不是业务必须的话，建议关闭，避免安全风险。优化后的WebSettings部分：

WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);
webSettings.setLoadWithOverviewMode(true);
webSettings.setUseWideViewPort(true);
webSettings.setAllowFileAccess(true);
webSettings.setAllowContentAccess(true);
// 非必须的话建议关闭这两个
// webSettings.setAllowFileAccessFromFileURLs(true);
// webSettings.setAllowUniversalAccessFromFileURLs(true);
webSettings.setDomStorageEnabled(true);
webSettings.setGeolocationEnabled(true);

最后测试步骤 #

1. 把以上修改应用到你的项目中
2. 重新编译运行App
3. 首次打开时会弹出权限申请对话框，允许文件访问权限
4. 点击网页中的文件选择按钮，应该就能正常打开相册选择图片了

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