PAYATHON 2026

AWS Lambda 中 LibreOffice 进程和线程持续增长如何处理?

数据小陈

结论

先确认每次转换后留下的是仍在运行的进程、未回收的 zombie process,还是某个长期存活进程中新增的线程,再分别处理退出和回收问题。现有报错不足以确定这是 LibreOffice 7.2 的某个具体缺陷。

fork: Resource temporarily unavailable 和 osl::Thread::create failed 都表明创建进程或线程失败。结合调用次数增加、资源数量持续上升和题述的 1024 限制,可以优先排查进程生命周期。

将 exec() 改成 execFile() 可以省去额外的命令 shell,并正确传递文件名,但这项修改本身不能保证解决子孙进程残留。

先确认哪些资源在增长

在同一个 Lambda execution environment 中,分别记录转换前、转换完成后和下一次调用开始时的进程情况。可以在带有 ps 的诊断镜像中执行:

ps -eo pid,ppid,stat,nlwp,comm,args

重点查看新增条目的 PID、PPID、STAT 和 NLWP:

观察结果 排查方向
每次调用后出现新的 PID,且进程仍在运行 检查转换是否真正结束,以及超时后是否只终止了启动脚本
STAT 以 Z 开头的条目持续增加 检查父进程是否回收退出状态,以及孤儿进程由谁接管
PID 基本不变,但某个进程的 NLWP 持续增加 检查该进程的线程增长,不能只统计进程行数

还可以读取 /proc/<pid>/status 中的 Threads,核对线程数。仅凭每次增加约 6 个条目,无法认定它们全部来自 LibreOffice,应结合进程名、命令行和父子关系确认。

Lambda 的 warm invocations 会复用执行环境。handler 返回时,本次启动的后台进程未必都已退出,残留资源可能跨调用累积。

改用参数数组,并隔离每次转换

原代码通过字符串拼接命令,文件名包含空格或 shell 特殊字符时会产生参数解析问题。使用 execFile() 传递参数数组可以避免这个问题。

每次转换应使用独立的输出目录和 UserInstallation。独立 profile 可以隔离配置和锁状态,但不会自动回收进程。错误日志中已经出现 -env:UserInstallation=...,还需要确认实际执行路径每次是否都传入了独立值。

下面的示例保留 libreoffice7.2,改进了命令调用和结果检查,但不包含完整的进程树清理逻辑:

import { execFile } from 'child_process';
import { promisify } from 'util';
import { mkdtemp, stat } from 'fs/promises';
import { join, parse } from 'path';
import { pathToFileURL } from 'url';

const execFileAsync = promisify(execFile);

// inputPath must be an absolute path.
// timeoutMs must leave time for cleanup before the Lambda timeout.
export async function convertDocxToPdf(inputPath, timeoutMs) {
  const workDir = await mkdtemp('/tmp/lo-');
  const profileUrl = pathToFileURL(join(workDir, 'profile')).href;

  const args = [
    `-env:UserInstallation=${profileUrl}`,
    '--headless',
    '--nologo',
    '--nodefault',
    '--norestore',
    '--convert-to',
    'pdf',
    '--outdir',
    workDir,
    inputPath,
  ];

  const { stdout, stderr } = await execFileAsync(
    'libreoffice7.2',
    args,
    {
      timeout: timeoutMs,
      killSignal: 'SIGKILL',
      maxBuffer: 1024 * 1024,
    }
  );

  const pdfPath = join(workDir, `${parse(inputPath).name}.pdf`);
  const info = await stat(pdfPath);

  if (!info.isFile() || info.size === 0) {
    throw new Error('LibreOffice did not produce a non-empty PDF');
  }

  return { pdfPath, workDir, stdout, stderr };
}

示例省略了原命令中的 --view,专门用于文件转换。由于输出目录是新建的,检查到的 PDF 不会是上次调用遗留的同名文件。

timeoutMs 应根据 Lambda 剩余执行时间设置,为进程清理和错误处理留出时间。示例中的 maxBuffer 是输出缓冲区大小,不能用来限制进程数量。

成功上传 S3 并确认相关转换进程已经退出后,用 rm(workDir, { recursive: true, force: true }) 删除工作目录。如果失败,先完成进程清理再删除目录,以免仍在运行的进程继续访问 profile 或输出文件。

超时处理必须覆盖子孙进程

execFile() 不会额外启动命令 shell,但 libreoffice7.2 自身仍可能是启动脚本,并派生实际执行转换的进程。

示例中的 timeout 和 killSignal 只针对直接启动的子进程。如果启动脚本被终止后实际转换进程仍在运行,资源就会残留。进程快照确认存在这类残留时,需要增加进程树管理。

在 Linux 容器中,可以使用 spawn() 创建独立进程组,再由监督逻辑管理:

  1. 转换超时时,向本次任务的进程组发送 SIGTERM。
  2. 等待有限的退出宽限期后,向仍存活的成员发送 SIGKILL。
  3. 等待直接子进程关闭,并确认本次任务的剩余进程已退出,再结束 handler。

采用这种方式时,要确认 LibreOffice 派生的进程没有脱离该进程组。child.kill() 或 child.killed 都不能单独证明整个进程树已结束。不要将 pkill -f libreoffice 用作常规清理方式,因为它无法准确限定本次转换任务。

如果累积的是 zombie process

zombie process 已经退出,父进程需要通过 wait() 或 waitpid() 回收其退出状态。发送 SIGKILL 无法回收 zombie process。

先检查它们的 PPID。如果 zombie process 仍由存活的包装进程持有,就要修复该父进程的回收逻辑;如果孤儿进程被 PID 1 接管后没有得到回收,可以考虑在容器入口加入具备回收能力的 init,例如 tini。

对于使用题述 AWS 基础镜像的容器,可以采用以下入口包装形式:

# Add a verified tini binary compatible with the image architecture.
COPY tini /usr/local/bin/tini
RUN chmod +x /usr/local/bin/tini

ENTRYPOINT ["/usr/local/bin/tini", "--", "/lambda-entrypoint.sh"]

保留镜像原有的 handler CMD。构建前需要准备与镜像架构匹配的 tini,并验证包装后的 Lambda 入口能否正常工作。

tini 可以回收由它接管的孤儿进程,但无法替仍然存活的父进程回收该父进程持有的 zombie process,也不会自动终止所有后台转换任务。是否适用取决于前面记录的 PPID 和进程状态。

如何验证修复有效

在同一个执行环境中连续运行转换,覆盖此前出现增长的调用次数,包含正常转换、无效文档和超时场景。记录每次调用结束后的进程数、线程数和 zombie process 数量,确认它们回到稳定范围。

javaldx 的 Java 提示需要单独判断。资源耗尽可能导致启动探测失败,仅凭这段日志无法确定安装 Java 能解决问题。应在资源充足时复现单次转换,再判断是否存在 Java 依赖问题。

如果进程已正确退出和回收,计数仍持续增长,再结合具体进程、LibreOffice 构建版本和最小复现文件排查。可以升级版本作为对照实验;现有信息不足以确定某个版本已经修复该问题。

备注:内容仅供参考。