Lambda环境下GraphicsMagick调用toBuffer()返回空缓冲区问题

安全阿岳

2026-10-2

Lambda处理PDF生成缩略图空buffer错误解决方案

核心根因

你遇到的stream throws an empty buffer错误90%以上的场景是因为Node.js14.x对应的Lambda Amazon Linux 2运行时没有预装Ghostscript依赖：ImageMagick本身不具备PDF解析能力，必须调用Ghostscript渲染PDF为位图，缺少该依赖时就会生成空内容，触发空buffer错误，仅调整内存无法解决该问题。

具体修复步骤

步骤1：打包Ghostscript到Lambda部署包

在Amazon Linux 2环境下编译Ghostscript静态二进制文件，将编译好的gs二进制文件放到部署包根目录的bin文件夹下
在代码最顶部添加环境变量配置，让系统可以找到Ghostscript执行文件：

process.env.PATH = `${process.env.PATH}:${process.env.LAMBDA_TASK_ROOT}/bin`;

步骤2：修正gm处理PDF的参数逻辑

PDF为矢量格式，默认渲染分辨率极低，缺少分辨率配置也会导致生成空内容，调整处理逻辑如下：

const gm = require("gm").subClass({ imageMagick: true });
const fs = require("fs");
// 新增Ghostscript路径配置
process.env.PATH = `${process.env.PATH}:${process.env.LAMBDA_TASK_ROOT}/bin`;

const params = {
  Bucket: sourceBucket,
  Key: originalNameImg,
};

const pdf = await s3.getObject(params).promise();
// 校验拉取的PDF内容是否正常
if (!pdf.Body || pdf.Body.length === 0) {
  reject(new Error("S3拉取的PDF文件为空"));
  return;
}

const temp_file = mktemp.createFileSync(`/tmp/XXXXXX.pdf`);
fs.writeFileSync(temp_file, pdf.Body);

gm(temp_file + "[0]")
  .density(150, 150) // 先设置PDF渲染分辨率，保证内容正常生成
  .flatten() // 合并PDF透明层，避免jpg格式不兼容问题
  .resize(400, 400)
  .toBuffer("jpg", function(err, buffer) {
    if (err) {
      reject(err);
      return;
    }
    resolve(buffer);
  });