NodeJS下libreoffice-convert转Excel为PDF的问题及优化咨询

一、优化转换速度（5-10秒等待问题） #

• 复用LibreOffice常驻进程：默认每次转换都会启动新的LibreOffice进程，这是最大的性能开销。先在后台启动一个headless服务：

  soffice --headless --accept="socket,host=127.0.0.1,port=2002;urp;" --norestore --nolockcheck
  

  然后在Node.js中通过远程连接调用这个服务，避免重复启动进程，能把转换时间压缩到1-2秒内。
• 缓存高频请求的PDF：如果用户请求的是固定模板或高频查询的记录，用Redis或本地文件系统缓存生成好的PDF，以查询参数（比如时间范围、筛选条件）为缓存key，下次请求直接返回缓存文件，无需重复转换。
• 精简Excel文件：生成Excel时去掉冗余格式（比如重复的单元格样式、不必要的条件格式），只保留核心数据和必要的样式，减少LibreOffice的解析耗时。
• 并行处理转换任务：用Node.js的worker_threads或者第三方进程池库（如poolifier）处理转换逻辑，避免阻塞主进程，同时支持多请求并行转换，提升整体吞吐量。

二、修复列分页异常问题 #

• 在Excel生成阶段预设打印布局：这是最有效的方法，用你当前生成Excel的库（比如exceljs、xlsx）设置打印参数，强制所有列适配单页：
  以exceljs为例：

  const ExcelJS = require('exceljs');
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('Records');
  
  // 填充数据库记录到worksheet...
  
  // 设置横向打印+适配所有列到一页
  worksheet.pageSetup.orientation = 'landscape';
  worksheet.pageSetup.fitToPage = true;
  worksheet.pageSetup.fitToWidth = 1; // 强制所有列缩放到1页宽度
  // 缩小页边距，增加可打印区域
  worksheet.pageSetup.margins = {
    top: 0.4, left: 0.4, bottom: 0.4, right: 0.4,
    header: 0.2, footer: 0.2
  };
  
  // 保存Excel文件后再转PDF
  await workbook.xlsx.writeFile('./temp.xlsx');
  

• 调整LibreOffice转换参数：转换时添加打印适配参数，强制缩放：

  const libre = require('libreoffice-convert');
  const fs = require('fs');
  
  const inputPath = './temp.xlsx';
  const outputPath = './output.pdf';
  const file = fs.readFileSync(inputPath);
  
  const options = {
    filter: 'calc_pdf_Export',
    parameters: [
      '--headless',
      '--norestore',
      '--nolockcheck',
      '--print-settings="fit-to-page"'
    ]
  };
  
  libre.convert(file, '.pdf', options, (err, done) => {
    if (err) throw err;
    fs.writeFileSync(outputPath, done);
  });
  

• 手动调整列宽：计算所有数据列的内容宽度，设置合理的列宽总和，确保不超过横向页面的可打印宽度（A4横向可打印宽度约为19cm，换算成Excel列宽大概是70-80左右，可根据实际情况调整）。

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