Node.js异步函数调用Ruby生成PDF转Base64报错求助

我之前也踩过异步调用外部脚本生成文件的坑——同步跑完全正常，一换成异步就各种报错，多半是时序、路径或者错误处理没做到位。给你一套完整的解决方案，一步步来：

1. 先排查异步exec的核心问题 #

同步代码能跑通，说明Ruby脚本本身没问题，异步报错大概率是这几个原因：

• 相对路径坑：异步环境下Node.js的工作目录可能和同步时不一样，一定要用绝对路径调用Ruby脚本和指定PDF输出位置。
• 错误没捕获全：exec异步调用的错误会通过回调的第一个参数返回，而且Ruby的报错信息通常会输出到stderr，很多人容易忽略这个，导致根本不知道错在哪。
• 时序混乱：异步流程中如果没等Ruby生成完PDF就去读取文件，必然会报“文件不存在”的错误。

2. 完整的异步实现方案（用Promise+async/await更清晰） #

我推荐用util.promisify把exec转成Promise，再用async/await来控制流程，这样时序一目了然，也避免回调嵌套的混乱：

const fs = require('fs').promises;
const path = require('path');
const util = require('util');
// 把exec转成支持async/await的Promise版本
const execAsync = util.promisify(require('child_process').exec);

async function generatePdfBase64() {
  // 用绝对路径定义脚本和PDF输出位置，避免工作目录变化的问题
  const rubyScriptPath = path.resolve(__dirname, './scripts/generate_pdf.rb');
  const tempPdfPath = path.resolve(__dirname, './temp/temp_output.pdf');

  try {
    // 1. 异步调用Ruby脚本生成PDF
    const { stdout, stderr } = await execAsync(`ruby "${rubyScriptPath}" "${tempPdfPath}"`);
    
    // 打印Ruby的输出/警告，方便调试
    if (stderr) {
      console.warn(`Ruby脚本输出警告: ${stderr}`);
    }

    // 2. 先确认PDF文件真的生成了（防止Ruby脚本没报错但没生成文件）
    try {
      await fs.access(tempPdfPath);
    } catch (accessErr) {
      throw new Error(`PDF文件未生成: ${accessErr.message}`);
    }

    // 3. 读取PDF文件并转为Base64
    const pdfBuffer = await fs.readFile(tempPdfPath);
    const base64Str = pdfBuffer.toString('base64');

    // 4. 删除临时PDF文件
    await fs.unlink(tempPdfPath);

    // 5. 返回最终的Base64字符串
    return base64Str;
  } catch (err) {
    // 出错时尽量清理临时文件，避免残留垃圾
    try {
      await fs.unlink(tempPdfPath);
    } catch (cleanupErr) {
      console.warn(`清理临时PDF失败: ${cleanupErr.message}`);
    }
    throw new Error(`生成PDF失败: ${err.message}`);
  }
}

3. 配套Ruby脚本的注意点 #

确保你的Ruby脚本能接收命令行参数作为PDF输出路径，比如：

# generate_pdf.rb
require 'prawn'

# 从命令行参数获取输出路径
output_path = ARGV[0]

# 生成PDF的逻辑（这里用Prawn举例，你可以换成自己的生成逻辑）
Prawn::Document.generate(output_path) do
  text "PDF内容示例", size: 24
  move_down 20
  text "由Ruby脚本生成，Node.js异步调用"
end

4. 调试技巧 #

如果还是报错，按这几步排查：

• 把exec执行的命令（比如ruby "/xxx/generate_pdf.rb" "/xxx/temp_output.pdf"）复制到终端直接运行，看是否能正常生成PDF，排除Ruby脚本本身的问题。
• 重点看stderr的输出，Ruby的语法错误、依赖缺失（比如没装Prawn）都会在这里显示。
• 检查Node.js进程是否有读写临时PDF目录的权限。

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