Android WebView中启用网页文件上传按钮的方法咨询

嗨，作为Android开发新手遇到这个问题太正常了——WebView默认压根不支持文件上传的交互逻辑，得咱们手动配置几个关键环节才能让它跑起来。我给你整理了一步步的解决方案，跟着做就行：

第一步：配置WebView基础交互设置 #

首先得确保WebView启用了JavaScript（很多网页的上传按钮依赖JS逻辑），同时打开文件访问相关的权限开关。在你的onCreate方法里补充这些设置：

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

// 启用JavaScript，网页交互的基础
webSettings.setJavaScriptEnabled(true);
// 允许WebView访问本地文件
webSettings.setAllowFileAccess(true);
// 允许从文件选择器加载内容
webSettings.setAllowContentAccess(true);

第二步：通过WebChromeClient处理文件选择 #

WebView本身不会弹出系统的文件选择器，得靠WebChromeClient的onShowFileChooser方法来承接这个逻辑。咱们自定义一个WebChromeClient并重写这个方法：

先在MainActivity里定义两个全局变量：

private ValueCallback<Uri[]> filePathCallback;
private static final int FILE_CHOOSER_REQUEST_CODE = 1001;

然后给WebView设置这个自定义的WebChromeClient：

webView.setWebChromeClient(new WebChromeClient() {
    // Android 5.0及以上的文件选择回调
    @Override
    public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
        // 先保存回调实例，等用户选完文件再触发
        MainActivity.this.filePathCallback = filePathCallback;
        
        // 创建系统文件选择的Intent
        Intent intent = fileChooserParams.createIntent();
        try {
            // 启动文件选择器
            startActivityForResult(intent, FILE_CHOOSER_REQUEST_CODE);
        } catch (ActivityNotFoundException e) {
            // 万一没有可用的文件选择器，给WebView返回null
            filePathCallback.onReceiveValue(null);
            return false;
        }
        return true;
    }
});

第三步：处理文件选择的返回结果 #

在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) {
        Uri[] results = null;
        
        // 处理选择成功的情况
        if (resultCode == RESULT_OK && data != null) {
            ClipData clipData = data.getClipData();
            String dataString = data.getDataString();
            
            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 (filePathCallback != null) {
            filePathCallback.onReceiveValue(results);
            filePathCallback = null;
        }
    }
}

第四步：处理Android 6.0+的运行时权限 #

如果你的应用要跑在Android 6.0及以上系统，得申请读取外部存储的权限（网页要访问本地文件必须要这个）。可以在启动文件选择器前先检查权限：

先定义权限请求的常量：

private static final int PERMISSION_REQUEST_CODE = 1002;

然后修改onShowFileChooser里启动Intent的逻辑，加上权限检查：

// 检查读取存储权限
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    // 申请权限
    ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, PERMISSION_REQUEST_CODE);
} else {
    // 权限已授予，直接启动文件选择器
    startActivityForResult(intent, FILE_CHOOSER_REQUEST_CODE);
}

最后重写权限申请结果的处理方法：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == PERMISSION_REQUEST_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限通过，重新触发文件选择
            if (filePathCallback != null) {
                Intent intent = FileChooserParams.DEFAULT_CHOOSER_PARAMS.createIntent();
                startActivityForResult(intent, FILE_CHOOSER_REQUEST_CODE);
            }
        } else {
            // 权限被拒绝，给WebView返回null
            if (filePathCallback != null) {
                filePathCallback.onReceiveValue(null);
                filePathCallback = null;
            }
        }
    }
}

最后：在Manifest里声明必要权限 #

别忘了在AndroidManifest.xml里加这些权限：

<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 13以下用这个权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13+ 用细分的媒体权限，按需添加 -->
<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" />

这样一套配置下来，网页里的文件上传按钮应该就能正常唤起系统文件选择器，完成上传操作啦！

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