AWS Lambda中FFmpeg生成S3视频缩略图为空的问题求助

阿华AIGC实验室

2026-5-6

解决Lambda中FFmpeg触发SIGSEGV导致生成空截图的问题

我之前在Lambda里处理视频截图时也碰到过几乎一模一样的问题——FFmpeg进程报SIGSEGV段错误，生成的截图是空文件，表面日志还没明显报错。结合你的代码和问题描述，咱们一步步来解决：

核心问题分析

SIGSEGV（段错误）本质是进程试图访问未授权的内存区域，在Lambda环境里最常见的诱因有这几个：

Lambda分配的内存不足，FFmpeg处理视频时内存溢出
FFmpeg命令参数或管道处理逻辑有问题，导致写入/读取异常
未监听FFmpeg的stderr，丢失了关键的错误排查信息
临时文件的写入时机控制不当，提前终止了写入
直接用S3路径作为FFmpeg输入（Lambda环境下FFmpeg无法直接读取S3对象）

具体修复步骤

1. 先给Lambda加内存（最容易忽略但见效快）

Lambda默认内存是128MB，这对FFmpeg处理视频来说远远不够——哪怕是截取一帧，解码视频也需要一定内存。建议直接把内存调到512MB或更高（在Lambda控制台的「配置」→「常规配置」里修改）。我之前就是把内存从128MB升到512MB后，大部分SIGSEGV问题直接消失了。

2. 修复FFmpeg命令与管道逻辑

你的代码里有几个可以优化的点：

用-代替pipe:1，部分FFmpeg版本在Lambda环境里对-的管道支持更稳定
不要在FFmpeg的close事件里调用tmpFile.end()，应该等临时文件的finish事件确认写入完成
一定要监听FFmpeg的stderr，之前你没做这个，导致看不到FFmpeg内部的错误日志，这对排查问题至关重要
如果target是S3路径，必须先把文件下载到/tmp目录再传给FFmpeg（FFmpeg无法直接读取s3://格式的路径）

修改后的代码示例：

const { spawn } = require('child_process');
const { createWriteStream, statSync, createReadStream } = require('fs');
const { S3Client, GetObjectCommand } = require('@aws-sdk/client-s3');

const s3Client = new S3Client();
// 确保ffmpegPath是Lambda层或部署包中的正确路径，比如/opt/bin/ffmpeg
const ffmpegPath = '/opt/bin/ffmpeg';

// 先把S3视频下载到/tmp
async function downloadS3FileToTmp(bucket, key) {
  const tmpPath = `/tmp/${Date.now()}-video.mp4`;
  const command = new GetObjectCommand({ Bucket: bucket, Key: key });
  const response = await s3Client.send(command);
  return new Promise((resolve, reject) => {
    const writeStream = createWriteStream(tmpPath);
    response.Body.pipe(writeStream);
    writeStream.on('finish', () => resolve(tmpPath));
    writeStream.on('error', reject);
  });
}

async function generateVideoScreenshot(s3Bucket, s3Key) {
  // 先下载S3视频到本地临时目录
  const localVideoPath = await downloadS3FileToTmp(s3Bucket, s3Key);
  const tmpScreenshotPath = '/tmp/screenshot.jpg';

  return new Promise((resolve, reject) => {
    const tmpFile = createWriteStream(tmpScreenshotPath);

    // 调整FFmpeg参数，用"-"作为输出目标（等价于pipe:1，兼容性更好）
    const ffmpegArgs = [
      '-ss', '00:00:05',
      '-i', localVideoPath,
      '-vf', 'thumbnail,scale=200:200',
      '-qscale:v', '2',
      '-frames:v', '1',
      '-f', 'image2',
      '-c:v', 'mjpeg',
      '-'
    ];

    const ffmpeg = spawn(ffmpegPath, ffmpegArgs);

    // 把FFmpeg的标准输出导向临时文件
    ffmpeg.stdout.pipe(tmpFile);

    // 监听临时文件的finish事件，确认写入完成后再resolve
    tmpFile.on('finish', () => {
      // 检查文件大小，确认非空
      const fileStats = statSync(tmpScreenshotPath);
      console.log(`截图文件已生成，大小：${fileStats.size}字节`);
      resolve(tmpScreenshotPath);
    });

    // 监听FFmpeg的错误事件
    ffmpeg.on('error', (err) => {
      console.error('FFmpeg进程启动失败:', err);
      tmpFile.destroy(); // 清理临时文件
      reject(err);
    });

    // 监听FFmpeg的退出事件，捕获异常退出
    ffmpeg.on('close', (code, signal) => {
      console.log(`FFmpeg进程退出，代码：${code}，信号：${signal}`);
      if (code !== 0 && signal !== 'SIGTERM') {
        reject(new Error(`FFmpeg异常退出，信号：${signal}`));
      }
    });

    // 关键！监听FFmpeg的stderr，获取内部错误日志
    ffmpeg.stderr.on('data', (data) => {
      console.error('FFmpeg内部日志:', data.toString());
    });
  });
}