Android WebView文件选择按钮失效：ActivityResult.getResultCode()恒为0

核心问题分析 #

你遇到的问题本质是WebView 文件上传的回调链路未正确打通，结合 Target SDK 33 的 API 特性，导致选择文件后返回结果异常。以下是针对性修复步骤：

1. 正确配置 WebChromeClient 的文件选择回调 #

WebView 的文件上传按钮不会自动触发系统选择器，必须重写 WebChromeClient 的 onShowFileChooser 方法，这是实现文件选择的核心入口：

private ValueCallback<Uri[]> mFilePathCallback;
private final ActivityResultLauncher<Intent> filePickerLauncher = registerForActivityResult(
    new ActivityResultContracts.StartActivityForResult(),
    result -> {
        if (mFilePathCallback == null) return;
        
        Uri[] results = null;
        // 处理返回结果
        if (result.getResultCode() == Activity.RESULT_OK && result.getData() != null) {
            Uri data = result.getData();
            results = new Uri[]{data};
        }
        // 必须调用此方法通知WebView结果，否则WebView会一直等待
        mFilePathCallback.onReceiveValue(results);
        mFilePathCallback = null;
    }
);

// 给WebView设置WebChromeClient
webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
        // 保存回调，用于后续返回结果
        mFilePathCallback = filePathCallback;
        
        // 构建文件选择Intent
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        // 根据WebView的文件选择参数设置类型，匹配HTML的accept属性
        String[] acceptTypes = fileChooserParams.getAcceptTypes();
        if (acceptTypes != null && acceptTypes.length > 0 && !acceptTypes[0].isEmpty()) {
            intent.setType(acceptTypes[0]);
        } else {
            intent.setType("*/*");
        }
        
        // 启动文件选择器
        filePickerLauncher.launch(intent);
        return true;
    }
});

2. Target SDK 33 权限注意事项 #

• 无需申请 READ_EXTERNAL_STORAGE 权限：使用 ACTION_GET_CONTENT 调用系统文件选择器时，系统会自动处理权限，无需手动申请。
• 若需直接访问文件路径（非文件上传必要场景），需针对 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" />
  

3. 常见错误排查 #

• 未调用 mFilePathCallback.onReceiveValue()：哪怕用户取消选择，也要调用此方法传入 null，否则 WebView 会一直处于等待状态，后续点击文件按钮无响应。
• Intent 类型不匹配：确保 Intent 的 setType 值与 HTML 中 input 标签的 accept 属性一致，比如 image/* 对应图片选择。
• ActivityResultLauncher 注册时机错误：registerForActivityResult 必须在 Activity/Fragment 的 onCreate 阶段调用，不能在每次点击时重复注册。
• WebView 基础配置缺失：确保启用 JavaScript 和 DOM 存储（部分表单依赖）：

  WebSettings settings = webView.getSettings();
  settings.setJavaScriptEnabled(true);
  settings.setDomStorageEnabled(true);
  

4. 测试用 HTML 示例 #

可用以下页面验证前端逻辑：

<!DOCTYPE html>
<html>
<body>
    <form method="post" enctype="multipart/form-data">
        <input type="file" name="file" accept="image/*">
        <input type="submit" value="上传">
    </form>
</body>
</html>

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