Java手动生成PDF插入JPEG图片失败问题排查

以下是核心问题点和对应解决思路：

1. 硬编码的/Length值不匹配实际JPEG字节数 #

你在4号对象里写死了/Length 8000，但PDF要求这个值必须严格等于JPEG原始字节流的长度。长度不匹配会导致解析器无法正确读取图片数据，直接引发显示失败。
解决：用读取到的字节数组长度动态生成该值，Java代码示例：

byte[] jpegBytes = Files.readAllBytes(Paths.get(image.getPath()));
// 生成PDF时替换为 /Length " + jpegBytes.length + "

2. Stream块格式错误 #

PDF对stream格式的要求非常严格：

• stream关键字后必须紧跟换行符
• JPEG字节流不能带有任何额外的缩进、空格前缀
• endstream必须直接衔接在JPEG字节末尾（仅允许隔一个换行，不能有多余字符）

你当前的stream块里有缩进（***前的空格），这些空格会被算作stream内容的一部分，污染原始JPEG数据，导致无法解码。修正后的4号对象示例：

4 0 obj
<<
  /Type /XObject
  /Filter /DCTDecode
  /Length [实际JPEG字节数]
  /ColorSpace /DeviceRGB
  /Height 241
  /Width 209
  /Subtype /Image
  /BitsPerComponent 8
>>
stream
[直接写入JPEG原始字节，无任何前缀]
endstream
endobj

3. 颜色空间与实际图片不匹配 #

你设置了/ColorSpace /DeviceRGB，但如果目标JPEG是灰度单通道格式，这个配置会导致解析失败。
验证并修正：用Java代码判断图片真实颜色空间：

BufferedImage img = ImageIO.read(new File(image.getPath()));
ColorModel colorModel = img.getColorModel();
String colorSpace;
if (colorModel.getNumComponents() == 1) {
    colorSpace = "/DeviceGray";
} else if (colorModel.getNumComponents() == 3) {
    colorSpace = "/DeviceRGB";
} else {
    // 特殊格式（如CMYK）需对应调整，JPEG用于PDF一般为RGB/灰度
    colorSpace = "/DeviceRGB";
}
// 生成PDF时替换/ColorSpace的值

4. 宽高是否与JPEG原始数据一致 #

如果图片带有EXIF旋转信息，BufferedImage.getData()获取的宽高可能是旋转后的结果，但JPEG原始字节流的宽高是旋转前的，这会导致图片显示扭曲或不显示。
验证：直接解析JPEG文件头获取原始宽高，而非依赖BufferedImage的结果，比如读取JPEG的SOF段提取真实尺寸。

5. 简化测试排除其他问题 #

先去掉变换矩阵，用最基础的绘制指令测试：

5 0 obj 
<<
  /Length 20 
>> 
stream 
q 
1 0 0 1 0 0 cm
/Im1 Do 
Q 
endstream 
endobj

如果这样能显示，再逐步调整变换矩阵，排除坐标或缩放的问题。

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