本地正常的Node.js应用在GAE弹性环境中转PDF性能骤降问题排查

核心问题概述 #

基于bcgovimages/alpine-node-libreoffice镜像的Node.js应用，本地/本地Docker环境中getWordDocument函数的docx转pdf操作耗时10-12秒，但部署到GAE弹性环境后耗时长达2-3分钟，其他与存储桶、API交互的模块无延迟。本地设备为8GB内存、12代Intel i5，当前使用GCP免费配额，怀疑资源不足。

1. GAE弹性环境默认资源配额不足 #

GAE弹性环境免费配额默认仅0.25 vCPU、0.5GB内存，而LibreOffice是CPU和内存密集型工具，文档转换时需要加载字体、渲染内容，资源不足会导致严重卡顿。

解决建议：
在app.yaml中明确配置更高资源（注意超出免费配额会产生费用）：

resources:
  cpu: 1
  memory_gb: 1
  disk_size_gb: 10

测试不同资源配置的性能，找到最优平衡点。

2. LibreOffice进程重复启动开销 #

当前代码每次转换都通过exec启动新的LibreOffice进程，GAE容器资源受限，进程启动开销被放大，而本地资源充足启动更快。

代码优化建议：

• 启动常驻LibreOffice进程，通过套接字复用，避免重复启动：

// 应用启动时初始化常驻进程
const libreOfficeProcess = exec('libreoffice --headless --accept="socket,host=127.0.0.1,port=2002;urp;" --nofirststartwizard');
// 后续使用UNO接口或`libreoffice-convert`库调用该进程

• 替换exec为execFile，减少shell解析开销同时避免命令注入：

execFile('libreoffice', ['--headless', '--convert-to', 'pdf', `./assets/${filename}.docx`, '--outdir', './assets/'], (error, stdout, stderr) => {
  // 原有逻辑不变
});

3. 本地文件系统性能差异 #

GAE弹性环境的临时磁盘性能远不如本地SSD，fs.writeFileSync和文件读取操作会增加额外耗时。

优化建议：

• 避免本地文件中转，直接在内存中处理：用Packer.toBuffer生成的buffer直接流传递给转换工具，上传GCS时也直接用内存流，无需写入本地文件。
• 配置tmpfs挂载临时目录提升IO性能，在app.yaml中添加：

runtime_config:
  tmpfs:
    - path: /app/assets
      size: 512Mi

4. 字体加载延迟 #

GAE环境可能缺少常用字体，或字体加载路径存在延迟，导致LibreOffice转换时额外耗时搜索字体。

排查/解决：
在Dockerfile中安装常用字体包：

RUN apk add --no-cache ttf-dejavu ttf-liberation

检查LibreOffice字体配置，确保字体路径正确，避免运行时动态搜索。

5. 代码异步逻辑不规范 #

当前代码存在冗余的await + then写法，且exec使用回调式异步，可能导致时序控制混乱，间接影响性能排查。

代码优化：

• 统一用async/await风格，将exec封装为Promise：

const { promisify } = require('util');
const exec = promisify(require('child_process').exec);

// 转换部分改为：
await exec(`libreoffice --headless --convert-to pdf ./assets/${filename}.docx --outdir ./assets/`);
const urls = await uploadDocs(filename);
res.json({ urls: urls });

• 简化冗余写法：

const buffer = await Packer.toBuffer(doc);
fs.writeFileSync(`./assets/${filename}.docx`, buffer);

内容的提问来源于stack exchange，提问作者M. Maiz Nadeem