安卓自定义ContentProvider提供HTML文件浏览器仅下载不渲染问题排查

Chrome、Edge等浏览器以及系统HTML查看器处理content协议URI时，除了你排查到的openFile()和getType()方法外，还会调用query()方法请求OpenableColumns类定义的DISPLAY_NAME（文件名）、SIZE（文件大小）两个元数据字段。
系统自带的FileProvider默认已经实现了对应的查询逻辑，所以可以被浏览器正常识别为可直接渲染的HTML文件。而你自定义的SimpleContentProvider没有实现query()方法返回这两个字段，浏览器无法获取文件的完整信息，就会将其判定为需要下载的未知流式资源，不会直接渲染。
此外你代码中还存在路径解析错误、Provider权限配置不合理的潜在问题，也可能导致兼容性异常。

1. 补全ContentProvider的query方法实现 #

在SimpleContentProvider中增加query()方法的实现，返回浏览器需要的文件元数据：

@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
    // 未指定返回字段时默认返回文件名和大小
    if (projection == null) {
        projection = new String[]{OpenableColumns.DISPLAY_NAME, OpenableColumns.SIZE};
    }
    String path = uri.getPath();
    File file = new File(path);
    if (!file.exists()) {
        throw new FileNotFoundException("文件不存在：" + path);
    }
    // 构造返回结果的Cursor
    MatrixCursor cursor = new MatrixCursor(projection);
    Object[] row = new Object[projection.length];
    for (int i = 0; i < projection.length; i++) {
        if (OpenableColumns.DISPLAY_NAME.equals(projection[i])) {
            row[i] = file.getName();
        } else if (OpenableColumns.SIZE.equals(projection[i])) {
            row[i] = file.length();
        }
    }
    cursor.addRow(row);
    return cursor;
}

2. 修复路径解析逻辑 #

修改openFile()方法中获取路径的逻辑，不要使用getEncodedPath()（返回的是URL编码后的字符串，包含特殊字符时会解析错误），改为使用getPath()：

@Override
public ParcelFileDescriptor openFile(Uri uri, String mode) throws FileNotFoundException {
    Log.d(TAG, "open-File() mode: " + mode );
    // 替换getEncodedPath为getPath
    String path = uri.getPath();
    Log.d(TAG, "uri path: " + path );
    // 其余原有逻辑保持不变
    File f = new File(path);
    if ( ! f.exists() ) {
        Log.d(TAG, "path does not exist" );
        throw new FileNotFoundException("in SimpleContentProvider\n" + uri.getPath());
    }
    if ( mode.equals("r") )
        return (ParcelFileDescriptor.open(f,ParcelFileDescriptor.MODE_READ_ONLY));
    return (ParcelFileDescriptor.open(f,ParcelFileDescriptor.MODE_READ_WRITE)); 
}

3. 优化Provider权限配置 #

修改Manifest中Provider的配置，关闭exported属性（不需要导出Provider，你已经通过Intent的Flag授予了临时读权限，导出反而有安全风险，也会和系统FileProvider行为不一致）：

<provider
    android:name=".SimpleContentProvider"
    android:authorities="${applicationId}.simpleprovider"
    android:enabled="true"
    android:exported="false" />

4. 优化MIME类型返回的容错性 #

部分定制ROM的MimeTypeMap可能存在映射缺失，可以对HTML格式做兜底处理，避免返回错误的MIME类型：

@Override
public String getType(Uri uri) {
    Log.d(TAG, "get-Type() getPath(): " + uri.getPath() );
    String path = uri.getPath();
    String extension = getExtension(path);
    // HTML格式兜底处理
    if ("html".equalsIgnoreCase(extension) || "htm".equalsIgnoreCase(extension)) {
        return "text/html";
    }
    MimeTypeMap mimeTypeMap = MimeTypeMap.getSingleton();
    String mimeType = mimeTypeMap.getMimeTypeFromExtension(extension);
    return mimeType != null ? mimeType : "application/octet-stream";
}

5. 优化Intent启动逻辑 #

仅授予读权限即可，不需要授予写权限，避免不必要的权限风险：

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setDataAndType(uri, mimetype);
// 仅保留读权限
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
context.startActivity(intent);

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