Android WebView应用文件上传功能失效问题排查求助

嘿，这个问题我太熟了！WebView本身不像手机自带浏览器那样默认就处理了文件上传的逻辑，所以你得手动给它加几个关键配置和回调，才能让上传按钮正常唤起文件选择器。我给你一步步拆解解决方案：

问题根源 #

系统浏览器自带了文件选择的处理逻辑，但WebView是个“轻量化”的网页容器，默认不会响应网页的文件上传请求——你得告诉它「当用户点上传按钮时，要启动文件选择器，还要把选好的文件返回给网页」。

具体解决步骤 #

1. 先配好必要的权限 #

在AndroidManifest.xml里添加文件访问权限，不同Android版本的权限略有区别：

<!-- 适配Android 9及以下的文件读取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 适配Android 10+的媒体文件权限，更精准 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

<!-- 如果你的目标SDK是30+，可以加这个临时兼容旧存储模型的配置 -->
<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

注意：Android 6.0及以上版本，还需要在代码里动态申请READ_EXTERNAL_STORAGE（或对应媒体权限），不然权限会被拒绝。

2. 重写WebChromeClient处理上传请求 #

WebView需要通过WebChromeClient的回调来响应网页的文件选择请求，你得在初始化WebView的地方加上这段代码：

首先在你的Activity/Fragment里定义一个请求码和回调变量：

// 自定义的文件选择请求码
private static final int FILE_CHOOSER_REQUEST_CODE = 1001;
// 用于接收文件选择结果的回调（Android 5.0+）
private ValueCallback<Uri[]> mFilePathCallback;
// 兼容Android 5.0以下的回调
private ValueCallback<Uri> mUploadMsg;

然后给WebView设置WebChromeClient：

webView.setWebChromeClient(new WebChromeClient() {
    // 处理Android 5.0及以上的文件选择请求
    @Override
    public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
        // 先清空之前未处理的回调，避免重复请求导致异常
        if (mFilePathCallback != null) {
            mFilePathCallback.onReceiveValue(null);
        }
        mFilePathCallback = filePathCallback;

        // 启动系统自带的文件选择器
        Intent intent = fileChooserParams.createIntent();
        try {
            startActivityForResult(intent, FILE_CHOOSER_REQUEST_CODE);
        } catch (ActivityNotFoundException e) {
            mFilePathCallback = null;
            Toast.makeText(YourActivity.this, "无法打开文件选择器", Toast.LENGTH_SHORT).show();
            return false;
        }
        return true;
    }

    // 兼容Android 5.0以下的版本（如果你的APP最低支持版本低于5.0，就保留这段）
    public void openFileChooser(ValueCallback<Uri> uploadMsg, String acceptType, String capture) {
        mUploadMsg = uploadMsg;
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("*/*"); // 允许选择所有类型文件，可根据需求修改
        startActivityForResult(Intent.createChooser(intent, "选择文件"), FILE_CHOOSER_REQUEST_CODE);
    }
});

3. 处理文件选择的返回结果 #

在Activity的onActivityResult方法里，把用户选好的文件Uri返回给WebView：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == FILE_CHOOSER_REQUEST_CODE) {
        // 处理Android 5.0+的回调结果
        if (mFilePathCallback != null) {
            Uri[] results = null;
            if (resultCode == RESULT_OK && data != null) {
                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 {
                    results = new Uri[]{data.getData()};
                }
            }
            // 把结果返回给网页
            mFilePathCallback.onReceiveValue(results);
            mFilePathCallback = null;
        }
        // 处理Android 5.0以下的回调结果
        else if (mUploadMsg != null) {
            Uri result = (resultCode == RESULT_OK && data != null) ? data.getData() : null;
            mUploadMsg.onReceiveValue(result);
            mUploadMsg = null;
        }
    }
}

4. 别忘了开启JavaScript（如果需要） #

如果你的网页上传按钮是通过JavaScript触发的，一定要确保WebView开启了JS支持：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);

额外小提醒 #

如果你的网页是HTTP协议，而Android 9.0+默认禁止加载混合内容（HTTPS页面里加载HTTP资源），可以加这段配置允许混合内容：

webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);

不过建议尽量把网站升级到HTTPS，更安全。

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