Cloud Run中Node.js执行gsutil命令失败：命令未找到问题排查

问题原因 #

你的Dockerfile采用多阶段构建，但第一阶段的gcr.io/google.com/cloudsdktool/cloud-sdk:latest镜像内容并未被复制到最终的node:14镜像中，导致运行环境缺少gsutil工具，执行命令时自然会提示找不到。

解决方案 #

方案1：调整多阶段构建，引入gsutil #

修改Dockerfile，从cloud-sdk镜像复制必要工具到Node.js镜像，并配置环境变量：

# 第一阶段：包含Google Cloud SDK的镜像
FROM gcr.io/google.com/cloudsdktool/cloud-sdk:latest as cloud-sdk

# 第二阶段：Node.js运行环境
FROM node:14
WORKDIR /app

# 从cloud-sdk阶段复制SDK文件到当前镜像
COPY --from=cloud-sdk /usr/lib/google-cloud-sdk /usr/lib/google-cloud-sdk
# 将gsutil所在目录加入系统PATH
ENV PATH="/usr/lib/google-cloud-sdk/bin:${PATH}"

# 复制应用代码并安装依赖
COPY . /app
RUN npm install

CMD ["node", "./index.js"]

方案2：在Node.js镜像中直接安装gsutil #

如果不想用多阶段构建，可在node镜像中直接安装Google Cloud SDK：

FROM node:14
WORKDIR /app

# 安装依赖并下载Google Cloud SDK
RUN apt-get update && apt-get install -y curl python3 && \
    curl https://sdk.cloud.google.com | bash -s -- --disable-prompts

# 将SDK的bin目录加入PATH
ENV PATH="/root/google-cloud-sdk/bin:${PATH}"

COPY . /app
RUN npm install

CMD ["node", "./index.js"]

方案3：使用Google Cloud Storage Node.js客户端（推荐） #

避免调用外部命令，直接用官方Node.js库操作Cloud Storage，更可靠且符合Node.js开发习惯：

1. 安装依赖：

npm install @google-cloud/storage

2. 替换原有的execSync代码，用客户端实现文件上传：

const { Storage } = require('@google-cloud/storage');
const fs = require('fs').promises;
const path = require('path');

async function uploadTmpDirToGCS() {
  const storage = new Storage();
  const bucket = storage.bucket('staging.xxxx-portal.appspot.com');

  // 递归遍历/tmp目录并上传所有文件
  async function traverseDir(dir) {
    const entries = await fs.readdir(dir, { withFileTypes: true });
    for (const entry of entries) {
      const fullPath = path.join(dir, entry.name);
      if (entry.isDirectory()) {
        await traverseDir(fullPath);
      } else {
        // 生成GCS上的文件路径（去掉/tmp前缀）
        const gcsFilePath = fullPath.replace('/tmp/', '');
        await bucket.upload(fullPath, { destination: gcsFilePath });
        console.log(`已上传 ${fullPath} 到 gs://staging.xxxx-portal.appspot.com/${gcsFilePath}`);
      }
    }
  }

  await traverseDir('/tmp');
}

// 执行上传逻辑
uploadTmpDirToGCS().catch(err => {
  console.error('上传到Cloud Storage失败:', err);
  process.exit(1);
});

该方案优势：无需安装额外工具，减少镜像体积；错误处理更灵活；支持异步操作，适配Node.js编程模型。

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