You need to enable JavaScript to run this app. 使用MuPDF新建PDF文档时调用insertPage抛出页面无效的越界异常
优惠活动
大模型
产品
解决方案
定价
更多

使用MuPDF新建PDF文档时调用insertPage抛出页面无效的越界异常

MuPDF 新建PDF时插入页面报错IndexOutOfBoundsException: at is not a valid page的排查指南

错误本质

这个报错和插入位置的索引值没有直接关系,是MuPDF原生JNI层做对象校验时抛出的:你传给insertPage方法的页面对象根本不符合合法PDF页的结构要求,原生层本来要输出「page at is not a valid page」的完整提示,因为传入的对象是空值,连索引值都无法解析,最终拼出了半截的at is not a valid page错误。

常见触发场景

  • addPage方法构造页面对象时校验失败,静默返回无效空对象,未在Java层抛出异常,直到调用insertPage时才触发原生层校验错误
    • 内容流中引用了未注册的资源:你写的内容流里包含q 200 0 0 200 50 100 cm /Im0 Do Q指令,但全程没有创建对应的图像XObject,也没有把图像资源注册到页面的资源字典中,构造页面对象时会因为资源解析失败直接把对象置为无效状态
    • 字体资源引用不匹配:内容流中用/Tm 16 Tf引用字体,但addPage时传入的字体对象没有和/Tm这个资源名做映射,资源校验不通过
    • 重复注册对象:addFont返回的字体对象已经被自动加入文档的交叉引用表,手动再调用pdf.addObject(font)会导致对象引用标记混乱,后续构造页面对象关联资源时失败
  • 对API逻辑理解偏差:MuPDF Java绑定中的addPage方法只要参数全部校验通过,生成的合法页面对象会自动挂载到文档的页结构树中,不需要再手动调用insertPage做二次插入。如果你传给insertPage的是构造失败的无效对象,就会直接触发校验错误

修复方案

  • 移除冗余的手动对象注册:删掉pdf.addObject(font)的调用,避免对象引用标记混乱
  • 对齐资源引用关系:构造内容流时,确保所有用到的字体、图像资源都已经正确注册到页面的资源字典;如果没有准备对应图像资源,就删掉内容流中引用/Im0的绘制指令
  • 调整页面挂载逻辑:addPage调用成功后,通过pdf.countPages()确认页面已经自动加入文档,不需要额外执行insertPage操作——只有手动构造独立游离的页面对象时,才需要调用insertPage把对象挂载到文档的指定位置
  • 参考调整后的代码逻辑:
PDFDocument pdf = new PDFDocument();
PDFObject font = pdf.addFont(new Font("Times-Roman"));

Buffer buffer = new Buffer();
buffer.writeLine("10 10 280 330 re s");
buffer.writeLine("BT /F1 16 Tf 50 50 TD (Hello, world!) Tj ET");

// 构造页面,方法执行成功后页面会自动挂载到文档末尾
PDFObject page = pdf.addPage(new Rect(0,0,300,350), 0, font, buffer);

pdf.save(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)+"/output.pdf", "pretty,ascii,compress-images,compress-fonts");
  • 如果确实需要绘制图像,先把创建好的图像对象注册为页面的XObject资源,再在内容流中用对应资源名调用Do指令,不要直接引用未定义的XObject名称

内容的提问来源于stack exchange,提问作者Lak

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 19:45:03