本文档旨在解决使用较新版本的 SSRS (SQL Server Reporting Services) 生成 PDF 文件时，PDF 版本默认为 1.7，而某些旧版 PDF 处理库（例如 FPDI）仅支持 1.4 或更低版本的问题。文章将提供两种解决方案：一种是使用二进制/十六进制编辑器直接修改 PDF 文件头，另一种是使用 Ghostscript 将 PDF 文件降级到较低版本。
在使用 SQL Server Reporting Services (SSRS) 生成 PDF 文件时，你可能会遇到 PDF 版本兼容性问题。较新版本的 SSRS 默认生成 PDF 1.7 格式的文件，这可能会导致某些旧的 PDF 处理库无法正常工作。例如，FPDI PDF-Parser 库可能只支持 PDF 版本 1.4 或更低版本。本文将介绍两种将 SSRS 生成的 PDF 版本降级到 1.3 或 1.4 的方法。
方法一：使用二进制/十六进制编辑器修改 PDF 文件头
这种方法简单直接，但存在一定的风险。它通过修改 PDF 文件的文件头，将版本号从 1.7 更改为 1.3。请务必备份原始 PDF 文件，以防修改失败导致文件损坏。
步骤：
- 获取二进制/十六进制编辑器： 例如，BBE (Binary Block Editor) 或其他类似的工具。确保该编辑器允许你直接编辑二进制数据。
- 打开 PDF 文件： 使用二进制/十六进制编辑器打开要修改的 PDF 文件。
- 查找文件头： 在文件的开头，你会看到类似 %PDF-1.7 的字符串。这就是 PDF 版本标识。
- 替换版本号： 将 %PDF-1.7 替换为 %PDF-1.3。务必确保替换后的字符串长度与原始字符串完全相同，不要增加或减少任何字节。 使用十六进制编辑器替换时，要确认1.7对应的十六进制码替换成1.3对应的十六进制码。
- 保存文件： 保存修改后的 PDF 文件。
注意事项：
- 风险提示： 这种方法属于“dirty way”，可能导致 PDF 文件损坏。修改前务必备份原始文件。
- 字节长度： 替换操作必须保持字节长度不变，否则会破坏 PDF 文件的结构，导致文件无法打开或显示错误。
- 兼容性： 即使成功修改了文件头，也不能保证 PDF 文件与所有旧版 PDF 处理库完全兼容。因为 PDF 1.5 或更高版本中引入的新对象可能仍然存在，并导致 FPDI 等库出现问题。
方法二：使用 Ghostscript 降级 PDF 版本
Ghostscript 是一个强大的页面描述语言解释器和转换器，它可以将 PDF 文件转换为不同的版本。这是更安全、更推荐的方法。
步骤：
- 安装 Ghostscript： 如果你的系统上没有安装 Ghostscript，请先下载并安装它。你可以从 Ghostscript 官方网站下载适合你操作系统的版本。
- 使用命令行降级 PDF： 打开命令行终端，并使用以下命令将 PDF 文件降级到 1.3 版本：
gs -sDEVICE=pdfwrite -o output.pdf input.pdf -dPDFSETTINGS=/prepress -dCompatibilityLevel=1.3
- gs：调用 Ghostscript 命令。
- -sDEVICE=pdfwrite：指定输出设备为 PDF 写入器。
- -o output.pdf：指定输出文件名。将 output.pdf 替换为你想要的文件名。
- input.pdf：指定输入文件名。将 input.pdf 替换为你要降级的 PDF 文件名。
- -dPDFSETTINGS=/prepress：设置PDF预设，prepress是高质量的设置，同时兼容性较好。
- -dCompatibilityLevel=1.3：指定 PDF 兼容级别为 1.3。
- 可选参数： 可以尝试添加 -dNEWPDF 参数，在某些情况下可以提高兼容性。
gs -sDEVICE=pdfwrite -o output.pdf input.pdf -dPDFSETTINGS=/prepress -dCompatibilityLevel=1.3 -dNEWPDF
PHP 代码示例：
如果你需要在 PHP 脚本中执行 Ghostscript 命令，可以使用 exec() 函数：
注意事项：
- Ghostscript 版本： 不同版本的 Ghostscript 可能有不同的命令行参数。请参考 Ghostscript 的官方文档。
- 路径： 确保 Ghostscript 的可执行文件路径已添加到系统的环境变量中，或者在命令行中指定完整的路径。
- 权限： 确保 PHP 脚本有执行 Ghostscript 命令的权限。
- 错误处理： 在 PHP 脚本中，应该添加错误处理机制，以捕获 Ghostscript 命令执行失败的情况。
总结：
虽然使用二进制/十六进制编辑器修改 PDF 文件头是一种快速的解决方案，但它存在较高的风险。使用 Ghostscript 降级 PDF 版本是更安全、更可靠的方法，它能够确保 PDF 文件与旧版 PDF 处理库的兼容性。建议优先选择使用 Ghostscript 来解决 SSRS 生成 PDF 文件的版本兼容性问题。
