NodeJS使用GraphicMagick将单页PDF转JPEG出现黑图问题求助

核心原因 #

• 调用resize()时传入空字符串作为宽度参数，在单页PDF场景下，GraphicMagick无法正确读取单页PDF的原始尺寸计算宽高比，导致画布初始化异常
• 单页PDF默认携带透明背景层，转JPEG时没有显式合并背景的话，透明区域会被渲染为纯黑，多页PDF处理时默认会自动合并图层，所以没有这个问题

修复后代码 #

const gm = require("gm");
const imageMagick = gm.subClass({ imageMagick: true });

image = imageMagick(fileBuffer).selectFrame(0);

image.size(function onSizeComplete(err, size) {
   // 按原始宽高比提前计算目标宽度，避免传空值导致解析异常
   const targetHeight = 200;
   const targetWidth = Math.round((size.width / size.height) * targetHeight);
   image.quality(40)
        .flatten() // 合并透明层，默认填充白色背景，避免透明区域变黑
        .resize(targetWidth, targetHeight)
        .toBuffer("jpeg", async function (error, buffer) {
           if (error) {
               logger.info("error buffer: " + error);
           } else {
               //upload the image
           }
         });
           
});

可选优化配置 #

如果上述方案仍存在异常，可添加以下配置进一步兼容：

• 在selectFrame(0)后追加density(150,150)，显式指定PDF渲染DPI，避免低DPI导致的渲染异常
• 不需要严格固定高度的场景可使用.resize(null, 200)替代手动计算宽度，GraphicMagick会自动按比例适配宽度

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