Android中使用Intent.ACTION_VIEW打开PDF文档在部分PDF查看器中失效的问题排查

嘿，我明白你遇到的困扰了——同样是用Intent.ACTION_VIEW打开PDF，有些阅读器能正常加载指定文件，但WPS、Adobe Acrobat这类主流应用却只启动App本身，根本不打开目标文件。这其实是你的代码里几个关键细节没处理对，特别是Android的文件权限机制和Intent的正确用法，我来帮你拆解修复：

你的代码存在的核心问题 #

1. Uri.fromFile的兼容性问题：Android 7.0（API 24）及以上系统禁止直接将file://类型的Uri暴露给其他应用，会触发FileUriExposedException，而且像WPS、Adobe这类合规应用会直接拒绝处理这种不安全的Uri，自然只会启动自身。
2. Intent设置错误：你混用了setType和Intent.EXTRA_STREAM，但ACTION_VIEW的标准用法是通过setDataAndType来关联目标文件的Uri和MIME类型，EXTRA_STREAM更多用于ACTION_SEND这类分享场景，很多专业PDF阅读器根本不会去读取这个参数，这就是它们不加载文件的核心原因。
3. 冗余的权限标记：你重复调用了intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK)，而且只添加了写权限标记，忽略了更关键的读权限（PDF阅读器只需要读取文件内容）。

修复步骤 #

第一步：配置FileProvider（Android 7+必备） #

我们需要用FileProvider把file://Uri转换成安全的content://Uri，让其他应用能合法访问你的文件：

1. 在AndroidManifest.xml的<application>标签内添加FileProvider配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

2. 在res/xml目录下创建file_paths.xml文件（如果没有xml目录就新建一个），指定允许共享的文件路径：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 对应系统Download文件夹的路径 -->
    <external-path name="downloads" path="Download/" />
</paths>

第二步：修改viewPdf方法 #

替换掉原来的错误实现，改用正确的Intent配置和Uri生成方式：

public void viewPdf() {
    File outputFile = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), fileName);
    
    // 先检查文件是否存在，避免空指针或找不到文件的问题
    if (!outputFile.exists()) {
        // 这里可以添加用户提示，比如Toast.makeText(this, "文件不存在", Toast.LENGTH_SHORT).show();
        return;
    }

    Uri uri;
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        // Android 7+用FileProvider生成安全的content://Uri
        uri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", outputFile);
    } else {
        // 低于7.0的系统可以直接用file://Uri
        uri = Uri.fromFile(outputFile);
    }

    Intent intent = new Intent(Intent.ACTION_VIEW);
    // 用setDataAndType替代setType+EXTRA_STREAM，这是ACTION_VIEW的标准写法
    intent.setDataAndType(uri, "application/pdf");
    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    // 授予临时读写权限，确保目标应用能访问文件（读权限是必须的）
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

    // 检查是否有应用能处理这个Intent，避免因无PDF阅读器导致崩溃
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    } else {
        // 提示用户未安装PDF阅读器，比如Toast.makeText(this, "请安装PDF阅读器", Toast.LENGTH_SHORT).show();
    }
}

关键修复点说明 #

• FileProvider的作用：它不仅解决了Android 7+的文件暴露问题，还能临时授予其他应用访问文件的权限，确保WPS、Adobe这类应用能合法读取你的PDF文件。
• setDataAndType的必要性：这是ACTION_VIEW的标准调用方式，所有正规的PDF阅读器都会优先读取Intent的data字段来获取目标文件，而不是EXTRA_STREAM，这就解决了之前只启动App不加载文件的问题。
• 权限标记：FLAG_GRANT_READ_URI_PERMISSION是必须的，因为PDF阅读器需要读取文件内容；加上FLAG_GRANT_WRITE_URI_PERMISSION是为了兼容少数需要写权限的阅读器。
• 文件存在检查和Intent可处理性检查：这能提升用户体验，避免不必要的崩溃和困惑。

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