采用PDFium库的Aquos手机（Android4.4.2/API19）App崩溃问题排查

你遇到的是PDFium在Android 4.4.2设备上初始化时的原生段错误（SIGSEGV），从崩溃日志来看，是在完成FPDF库初始化后触发了空指针访问（地址0x00000000）。结合你的代码PdfDocument pdfDocument = pdfiumCore.newDocument(fileDescriptor)，我整理了几个核心原因和对应的修复方案：

可能的原因及修复步骤 #

1. 检查文件描述符的有效性 #

崩溃的核心大概率是传入的fileDescriptor无效或已被提前关闭，PDFium原生层尝试访问对应内存时触发了空指针错误：

• 确保调用newDocument前，文件描述符未被关闭；
• 提前验证目标文件状态：用File.exists()和File.canRead()确认文件存在且可访问；
• 避免重复复用同一个文件描述符，每次创建文档时重新打开文件获取新描述符。

示例代码：

File targetPdf = new File("你的PDF文件路径");
if (targetPdf.exists() && targetPdf.canRead()) {
    FileInputStream fis = null;
    try {
        fis = new FileInputStream(targetPdf);
        PdfDocument pdfDocument = pdfiumCore.newDocument(fis.getFD());
        // 执行PDF相关操作
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        if (fis != null) {
            try {
                fis.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

2. 确认PDFium库的版本兼容性 #

旧版本PDFium可能在Android 4.4.2（API19）上存在原生架构适配问题：

• 尝试升级到最新稳定版的PDFium依赖（比如如果你用的是android-pdf-viewer封装库，同步更新其核心依赖）；
• 检查build.gradle的ABI过滤配置，确保包含API19设备支持的架构（armeabi-v7a是必选，该版本设备大多支持此架构）。

3. 验证文件权限配置 #

虽然API19无需动态申请权限，但如果文件位于外部存储，需在Manifest中声明对应权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

同时注意不要访问应用私有目录外的无权限文件。

4. 检查PDF文件完整性 #

如果目标PDF文件损坏或格式异常，PDFium初始化时也可能触发崩溃：

• 用其他PDF阅读器打开文件，确认文件本身无损坏；
• 如果是创建新PDF，确保传入的是可写入的有效文件描述符。

崩溃日志参考 #

03-26 10:49:17.281 7289-7289/? D/jniPdfium: Init FPDF library
03-26 10:49:17.301 7289-7289/? A/libc: Fatal signal 11 (SIGSEGV) at 0x00000000 (code=1), thread 7289
03-26 10:49:17.401 251-251/? I/DEBUG: *
03-26 10:49:17.401 251-251/? I/DEBUG: Build fingerprint: 'KDDI/SHL25_jp_kdi/SHL25:4.4.2/S5290/01.00.00:user/release-keys'

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