Android WebView中Input type="file"图片上传失败问题求助

核心配置检查 #

1. WebView基础设置 #

确保WebView开启必要的JS支持和文件访问权限：

WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true); // 网页上传依赖JS，必须开启
settings.setAllowFileAccess(true);
settings.setAllowContentAccess(true);
settings.setDomStorageEnabled(true); // 部分网页需要存储支持

2. WebChromeClient文件选择回调实现 #

这是处理文件上传的核心，必须重写onShowFileChooser方法，适配Android不同版本的文件选择逻辑：

webView.setWebChromeClient(new WebChromeClient() {
    private ValueCallback<Uri[]> mFilePathCallback;
    private Uri mPhotoUri;
    private static final int REQUEST_CODE_FILE_CHOOSER = 1001;

    @Override
    public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
        mFilePathCallback = filePathCallback;
        
        // 构建拍照Intent
        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
            File photoFile = null;
            try {
                // 创建私有目录下的临时拍照文件
                photoFile = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), 
                        "temp_" + System.currentTimeMillis() + ".jpg");
            } catch (Exception ex) {
                ex.printStackTrace();
            }
            if (photoFile != null) {
                // Android 7.0+用FileProvider生成安全Uri
                mPhotoUri = FileProvider.getUriForFile(MainActivity.this,
                        "com.your.package.fileprovider", // 对应Manifest中的authority
                        photoFile);
                takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, mPhotoUri);
                
                // 构建相册选择Intent
                Intent contentIntent = new Intent(Intent.ACTION_GET_CONTENT);
                contentIntent.setType("image/*");
                
                // 弹出选择框，提供拍照/相册选项
                Intent chooserIntent = Intent.createChooser(contentIntent, "选择图片");
                chooserIntent.putExtra(Intent.EXTRA_INITIAL_INTENTS, new Intent[]{takePictureIntent});
                startActivityForResult(chooserIntent, REQUEST_CODE_FILE_CHOOSER);
            }
        }
        return true;
    }
});

3. 回调结果处理 #

在onActivityResult（或AndroidX的registerForActivityResult）中，正确传递Uri给WebView：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_FILE_CHOOSER && mFilePathCallback != null) {
        Uri[] results = null;
        if (resultCode == RESULT_OK) {
            if (data == null) {
                // 拍照场景：直接用之前保存的mPhotoUri
                if (mPhotoUri != null) {
                    results = new Uri[]{mPhotoUri};
                    // 通知系统扫描文件，确保WebView能识别
                    sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, mPhotoUri));
                }
            } else {
                // 相册选择场景：获取返回的Uri
                Uri dataUri = data.getData();
                if (dataUri != null) {
                    results = new Uri[]{dataUri};
                }
            }
        }
        // 回调给WebView完成上传流程
        mFilePathCallback.onReceiveValue(results);
        mFilePathCallback = null;
    }
}

AndroidManifest配置检查 #

1. 权限声明 #

根据Android版本添加必要权限：

<!-- 相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Android 10及以下需要存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

<!-- 声明相机硬件特性（非强制，适配无相机设备） -->
<uses-feature android:name="android.hardware.camera" android:required="false" />

2. FileProvider配置（Android 7.0+） #

添加FileProvider避免Uri暴露问题：

<application ...>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="com.your.package.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

3. file_paths.xml配置 #

在res/xml目录下创建该文件，指定FileProvider可访问的目录：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 应用私有图片目录，对应拍照文件路径 -->
    <external-files-path name="app_pictures" path="Pictures" />
</paths>

常见问题排查点 #

• 拍照文件未生成：检查临时文件路径是否正确，确保应用有对应目录的写入权限
• Uri未传递：拍照场景下不能依赖data.getData()，必须手动传入预先生成的mPhotoUri
• Android 11+适配：Scoped Storage下禁止直接访问外部存储根目录，必须使用应用私有目录或MediaStore
• WebView版本兼容：Android 5.x系统自带WebView可能存在JS API支持问题，建议更新系统WebView或引入androidx.webkit依赖

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