BaseMetas FileView 更新发布：升级 JDK 21，持续提升 PDF 与多页 TIFF 预览能力

​BaseMetas FileView 迎来新一轮版本更新。

本次更新重点围绕运行环境升级、PDF 转换与展示兼容性、多页图片预览等方面进行优化，进一步提升文件预览服务在复杂文件和异常文件场景下的稳定性与展示效果。

一、运行环境升级至 JDK 21

本次版本将 Java 运行环境由 JDK 17 升级至 JDK 21。

JDK 21 是长期支持版本，可为产品后续迭代提供更稳定的运行基础，同时获得更新的 Java 语言能力、运行时优化和安全支持。

对于私有化部署和长期运行的企业环境，本次升级也有助于提升整体技术栈的可维护性。

二、修复 Word 横向页面转换后的 PDF 方向问题

在部分 Word 文档中，页面会同时包含纵向和横向布局，例如：

• 报表页面；
• 宽表格页面；
• 图纸或流程图页面；
• 横向排版的合同附件。

此前，当源 Word 文档中的某一页设置为横向时，转换生成的 PDF 页面可能仍以纵向方向展示，导致页面内容被压缩、裁剪或无法完整显示。

本次更新修复了该问题，转换后能够正确保留源文档的页面方向，使横向页面按照正常宽度进行展示。

【修复前——横向页面被错误显示为纵向】

【修复后——正确保留横向页面方向】

三、优化 PDF 双页模式显示效果

双页模式适合合同、书籍、说明书、标书等多页文档的连续阅读。

本次更新进一步优化了 PDF 双页模式下的页面排列和展示效果，使左右页面的布局更加协调，页面间距和视觉对齐更加自然。

优化后，在连续翻页和大屏幕浏览场景下，可获得更接近纸质文档展开阅读的体验。

四、增强异常 PDF 文件的兼容能力

部分 PDF 文件虽然能够被特定软件打开，但其内部交叉引用表、对象偏移量或增量更新结构并不完全符合标准规范。

这类文件常见于：

• 非标准 PDF 生成工具；
• 老旧业务系统导出的 PDF；
• 扫描、合并或二次处理后的 PDF；
• 文件结构被错误修改或部分损坏的 PDF。

本次更新针对多种异常 PDF 结构进行了兼容处理，主要包括：

• startxref 指向 0；
• startxref 偏移位置存在误差；
• startxref 指向普通对象而非 xref；
• xref 对象偏移量错误；
• xref 对象偏移量全部指向 0；
• xref entry 未按固定宽度补零；
• 内容流或普通对象被错误标记为 free；
• trailer 中的 /Size 小于实际对象数量；
• xref 声明数量小于实际 entry 数量；
• 增量更新中的 /Prev 指向错误位置；
• CRLF 换行导致 xref entry 字节宽度异常。

通过对这些异常结构进行识别、修正和容错处理，BaseMetas FileView 可以正常解析更多非标准 PDF 文件，降低因文件结构异常导致的预览失败问题。

五、修复多页 TIFF 文件只能显示一页的问题

TIFF/TIF 格式经常用于扫描件、档案影像、票据、病历和电子卷宗等场景。

一个 TIFF 文件内部可以包含多个页面。此前在预览多页 TIFF 文件时，只能展示其中一页，无法查看文件内的其他页面。

本次更新补充了多页 TIFF 解析和展示能力，预览时可以按照页面顺序完整查看文件中的全部图像页。

该优化尤其适用于：

• 扫描档案；
• 多页票据；
• 电子卷宗；
• 传真文件；
• 批量扫描生成的 TIFF 文件。

【修复后——完整展示 TIFF 全部页面】

本次更新总结

本次版本更新虽然以问题修复和体验优化为主，但覆盖了企业文件预览中较为典型的复杂场景：

• 运行环境升级至 JDK 21；
• 正确保留 Word 横向页面方向；
• 优化 PDF 双页阅读体验；
• 增强异常 PDF 文件兼容能力；
• 支持多页 TIFF 文件完整预览。

BaseMetas FileView 将继续围绕文件格式兼容性、预览还原度、运行稳定性和企业部署体验进行持续优化，为 OA、档案、合同、知识库、网盘及其他业务系统提供更加可靠的文件预览能力。

​相关资料

BaseMetas IDP 介绍：https://basemetas.com/

社区版

• BaseMetas Fileview 产品介绍：https://fileview.basemetas.cn/docs/product/summary
• BaseMetas Fileview GitHub：https://github.com/basemetas/fileview