使用MuPDF新建PDF文档时调用insertPage抛出页面无效的越界异常
MuPDF 新建PDF时插入页面报错
IndexOutOfBoundsException: at is not a valid page的排查指南 错误本质
这个报错和插入位置的索引值没有直接关系,是MuPDF原生JNI层做对象校验时抛出的:你传给insertPage方法的页面对象根本不符合合法PDF页的结构要求,原生层本来要输出「page at 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
相关产品推荐
相关产品推荐

