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() 创建独立进程组,再由监督逻辑管理:
- 转换超时时,向本次任务的进程组发送
SIGTERM。 - 等待有限的退出宽限期后,向仍存活的成员发送
SIGKILL。 - 等待直接子进程关闭,并确认本次任务的剩余进程已退出,再结束 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 构建版本和最小复现文件排查。可以升级版本作为对照实验;现有信息不足以确定某个版本已经修复该问题。
备注:内容仅供参考。
