高并发请求下LibreOffice无头模式Excel转PDF功能失效问题

1. 单实例锁冲突：LibreOffice默认启用单实例机制，启动时会在用户配置目录生成.lock锁文件，短时间内发起大量转换请求时，多个进程同时争抢锁资源，获取不到锁的进程不会直接抛出错误，而是进入死循环等待状态，就是你观测到的soffice进程占用100%CPU的情况，后续所有新的转换请求都会因为无法拿到锁直接失效。
2. 进程残留问题：你当前的Node.js代码杀死的只是exec启动的父shell进程，而LibreOffice运行时会fork出独立的soffice子进程执行转换任务，父进程被杀后子进程会被系统init进程收养，导致你无法通过原pid kill掉残留进程，只要残留进程存在，锁文件就会一直存在，后续所有转换都无法正常执行。
3. 共享目录读写冲突：默认所有LibreOffice进程都会读写同一份用户配置目录（~/.config/libreoffice/）和系统临时目录，高并发下多个进程同时读写配置文件、临时缓存文件时很容易出现文件损坏、读写冲突，直接导致进程卡死无响应。

• 调整转换命令参数，禁用锁检查和异常恢复逻辑，避免单实例限制：

libreoffice --headless --norestore --nolockcheck --nologo --nodefault --convert-to pdf 119.xlsx --outdir /home/pdfs/19

• 每次转换指定独立的隔离用户配置目录，从根源避免共享目录冲突，在命令中加入-env:UserInstallation参数，每个请求生成唯一的临时目录作为独立配置路径，转换完成后自动删除该目录即可：

# 示例中随机ID可以用时间戳+随机数生成，保证每次请求唯一
libreoffice --headless --norestore --nolockcheck --nologo --nodefault -env:UserInstallation=file:///tmp/soffice_$(date +%s%N) --convert-to pdf 119.xlsx --outdir /home/pdfs/19

• 优化Node.js进程杀死逻辑，杀掉整个进程组避免子进程残留：

const child = exec(command, { 
  timeout: 10000, 
  maxBuffer: 20 * 1024,
  detached: true // 启用独立进程组
}, (error: any, stdout: any, stderr: any) => {
    // 执行完成后不管成功失败都杀掉整个进程组
    try {
        process.kill(-child.pid, 'SIGKILL')
    } catch (e) {}
    if (error) {
          console.log(`error: ${error.message}`);
          return reject(error);
    }
    if (stderr) {
          console.log(`stderr: ${stderr}`);
    }
    console.log(`stdout: ${stdout}`);
    resolve();
});

• 长期高并发使用建议搭建LibreOffice进程池，提前启动固定数量的headless服务进程监听不同端口，请求分发到空闲进程处理，避免频繁启停进程的开销，进一步降低冲突概率。

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