Firebase Cloud Functions执行npm命令时出错求助

错误根源 #

1. 环境路径差异：云端Node.js运行时中/bin/bash路径不存在，直接通过bash调用npm会触发ENOENT错误。
2. 文件系统权限限制：Cloud Functions部署后的代码目录是只读的，直接在原React项目目录执行npm i或npm run build会因权限不足失败。
3. 临时目录特性：云端函数的工作目录仅/tmp是可写的，但该目录会在函数空闲时被清理，无法持久化依赖或构建产物。

修正方案 #

1. 直接调用npm（绕过bash） #

无需通过bash间接执行npm，直接使用child_process.spawn调用npm可执行文件，云端Node.js环境默认已预装npm。

2. 利用临时目录操作 #

将React项目文件复制到/tmp目录（唯一可写路径）后再执行依赖安装和构建操作。

完整代码示例 #

const { execSync, spawn } = require('child_process');
const path = require('path');
const functions = require("firebase-functions");

// 安装依赖的Callable函数
exports.installModules = functions.https.onCall(async (data, context) => {
  try {
    // 本地React项目的相对路径（需根据你的项目结构调整）
    const localReactDir = path.join(__dirname, '../react-app');
    // 云端临时工作目录
    const tmpReactDir = '/tmp/react-app';

    // 创建临时目录并复制React项目文件
    execSync(`mkdir -p ${tmpReactDir} && cp -r ${localReactDir}/* ${tmpReactDir}/`);

    // 直接执行npm install
    return new Promise((resolve, reject) => {
      const npmInstall = spawn('npm', ['i'], {
        cwd: tmpReactDir,
        stdio: 'inherit'
      });

      npmInstall.on('close', (code) => {
        code === 0 
          ? resolve({ message: '依赖安装完成' })
          : reject(new functions.https.HttpsError('internal', `安装失败，退出码：${code}`));
      });

      npmInstall.on('error', (err) => {
        reject(new functions.https.HttpsError('internal', `执行错误：${err.message}`));
      });
    });
  } catch (err) {
    throw new functions.https.HttpsError('internal', `操作异常：${err.message}`);
  }
});

// 执行构建的Callable函数
exports.build = functions.https.onCall(async (data, context) => {
  try {
    const localReactDir = path.join(__dirname, '../react-app');
    const tmpReactDir = '/tmp/react-app';

    // 复制项目文件到临时目录（若依赖已安装可跳过，但tmp目录可能已被清理）
    execSync(`mkdir -p ${tmpReactDir} && cp -r ${localReactDir}/* ${tmpReactDir}/`);

    // 执行npm run build
    return new Promise((resolve, reject) => {
      const npmBuild = spawn('npm', ['run', 'build'], {
        cwd: tmpReactDir,
        stdio: 'inherit'
      });

      npmBuild.on('close', (code) => {
        if (code === 0) {
          // 若需保存构建产物，可在此将/tmp/react-app/build目录上传至Cloud Storage
          resolve({ message: '项目构建完成' });
        } else {
          reject(new functions.https.HttpsError('internal', `构建失败，退出码：${code}`));
        }
      });

      npmBuild.on('error', (err) => {
        reject(new functions.https.HttpsError('internal', `执行错误：${err.message}`));
      });
    });
  } catch (err) {
    throw new functions.https.HttpsError('internal', `操作异常：${err.message}`);
  }
});

关键注意事项 #

• 超时配置：依赖安装和构建耗时可能超过默认1分钟超时，需在firebase.json中调整函数超时（最大支持9分钟）：

  {
    "functions": {
      "runtimeOptions": {
        "timeoutSeconds": 540
      }
    }
  }
  

• 资源配置：构建过程对CPU和内存要求较高，建议在函数部署时指定更高配置（如2GB内存）：

  firebase deploy --only functions --memory=2GB
  

• 产物处理：/tmp目录无法持久化，构建完成后需将产物上传至Cloud Storage等持久化存储服务。
• 依赖兼容性：确保React项目的依赖可在云端Node.js环境正常安装（避免依赖本地编译的二进制包，或添加对应平台的兼容包）。

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