Android平台使用iText库读写PDF时文件不存在问题求助

我之前踩过几乎一模一样的坑，结合你描述的情况，咱们一步步排查和解决：

首先确认：文件真的被创建出来了吗？ #

Toast显示的路径看起来正常，但很可能文件根本没成功写入，或者是空文件。先加一段代码验证：

File pdfFile = new File(你的文件路径);
if (!pdfFile.exists()) {
    Toast.makeText(this, "PDF文件未生成", Toast.LENGTH_SHORT).show();
    return;
}
if (pdfFile.length() == 0) {
    Toast.makeText(this, "生成的PDF是空文件", Toast.LENGTH_SHORT).show();
    return;
}

也可以直接用设备的文件管理器手动导航到那个路径，看看有没有对应的PDF文件——有时候Toast里的路径少了后缀（比如没加.pdf），或者目录层级错了，肉眼很难发现。

最常见的坑：Android 7+的Uri暴露限制 #

从Android 7（API 24）开始，直接用file://格式的Uri给其他应用传递文件会触发FileUriExposedException，这时候系统会阻止打开，表现出来就是“文件不存在”，但实际文件是存在的。解决方法是用FileProvider生成content://格式的Uri：

步骤1：在Manifest中注册FileProvider #

<application>
    <!-- 其他代码 -->
    <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>
</application>

步骤2：创建文件路径配置文件 #

在res/xml目录下新建file_paths.xml（如果没有xml目录就自己建），内容根据你的存储路径调整：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 如果是存在外部存储根目录 -->
    <external-path name="external_root" path="." />
    <!-- 如果是存在Download目录，就用这个：
    <external-path name="download" path="Download/" />
    -->
</paths>

步骤3：修改打开PDF的Intent代码 #

Uri pdfUri;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // Android 7+用FileProvider生成Uri
    pdfUri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", pdfFile);
} else {
    // 旧版本直接用File Uri
    pdfUri = Uri.fromFile(pdfFile);
}

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setDataAndType(pdfUri, "application/pdf");
intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
// 必须添加这个标记，允许其他应用读取该Uri
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    Toast.makeText(this, "未找到可打开PDF的应用", Toast.LENGTH_SHORT).show();
}

权限相关的细节 #

1. 动态申请权限：Android 6.0（API 23）及以上，即使在Manifest里加了READ/WRITE_EXTERNAL_STORAGE，也要动态申请：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 100);
} else {
    // 执行创建PDF的逻辑
}

2. Android 10+的Scoped Storage：如果你的目标SDK是30+，直接用Environment.getExternalStorageDirectory()可能会被限制，更推荐用应用专属存储或者MediaStore来保存PDF，避免权限问题。

检查iText的写入逻辑 #

确保写入PDF时没有静默异常，一定要捕获并打印异常：

Document document = new Document();
try {
    PdfWriter.getInstance(document, new FileOutputStream(pdfFile));
    document.open();
    // 添加PDF内容的代码
    document.add(new Paragraph("测试内容"));
} catch (Exception e) {
    e.printStackTrace();
    Toast.makeText(this, "PDF创建失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
} finally {
    if (document.isOpen()) {
        document.close();
    }
}

如果写入时抛出异常（比如权限不足、磁盘空间不够），文件可能只生成了空文件或者根本没生成，这时候自然打不开。

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