使用iText新建PDF时压缩JPEG图片的最佳实践及缩放无效问题

我来帮你理清这个问题——你用image.scale(0.5f, 0.5f)后PDF大小没变化，核心原因是这个方法只是调整图片在PDF中的显示尺寸，并没有真正修改嵌入的图片像素数据，原始的3MB图片还是完整存在PDF里，所以文件大小没减。下面是几个能真正平衡图片质量和PDF大小的实用方案：

1. 对图片进行重新采样（修改像素数） #

这是最有效的压缩方式，直接减少图片的像素总量。你可以用iText的ResizeImage工具类，在创建ImageData时就完成缩放，这样嵌入PDF的是已经缩小的图片数据：

// 读取原始图片数据
ImageData originalImageData = ImageDataFactory.create(imagePath);
// 按0.5比例缩放（宽高都减半）
float targetWidth = originalImageData.getWidth() * 0.5f;
float targetHeight = originalImageData.getHeight() * 0.5f;
ImageData resizedImageData = ResizeImage.resize(originalImageData, targetWidth, targetHeight);
// 创建图片对象
Image image = new Image(resizedImageData);

这样处理后，图片的像素数变为原来的1/4，文件大小会显著降低，同时显示尺寸也会对应缩小（如果需要保持显示大小，可以后续再用scale()调整，但一般建议直接缩到目标显示尺寸）。

2. 调整JPEG压缩质量（不改变像素数） #

如果不想降低图片分辨率，只想通过牺牲少量质量来减小文件大小，可以设置JPEG的压缩质量参数：

ImageData imageData = ImageDataFactory.create(imagePath);
// 检查是否是RGB格式的JPEG（确保适用质量调整）
if (imageData.getColorSpace() == ColorSpaceConstants.CS_RGB) {
    // 设置压缩质量：0.0=最低质量，1.0=最高质量，这里用0.7平衡质量和大小
    imageData.setQuality(0.7f, true); // 第二个参数为true表示使用基线JPEG编码
}
Image image = new Image(imageData);

这个方法适合需要保留原始分辨率，但可以接受轻微画质损失的场景，比如网页预览、文档内嵌图片等。

3. 组合缩放+质量调整（最大化压缩效果） #

如果想要极致的压缩效果，可以同时使用上面两种方法：先把图片缩到合适的显示尺寸，再调整压缩质量，这样能在保证视觉效果的前提下把PDF大小压到最低：

ImageData originalImageData = ImageDataFactory.create(imagePath);
// 第一步：缩放图片到目标尺寸
ImageData resizedImageData = ResizeImage.resize(originalImageData, 
    originalImageData.getWidth() * 0.5f, 
    originalImageData.getHeight() * 0.5f);
// 第二步：调整压缩质量
if (resizedImageData.getColorSpace() == ColorSpaceConstants.CS_RGB) {
    resizedImageData.setQuality(0.6f, true);
}
Image image = new Image(resizedImageData);

关键注意点 #

• 避免只使用scale()：它只是视觉上的缩放，不会改变嵌入的原始图片数据，对PDF大小毫无帮助。
• 保留JPEG格式：确保iText没有将JPEG转成PNG等无损格式（iText默认会保留原始图片的压缩格式，但如果是从其他格式转换过来，需要注意）。
• 测试质量参数：不同图片的画质容忍度不同，建议多测试几个质量值（比如0.6-0.8），找到适合自己场景的平衡点。

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