Google Cloud Run构建Next.js应用报错：无效的Node.js版本22.*.*

核心问题 #

Google Cloud Run默认使用的ubuntu1804构建环境是已停止维护（EOL）的旧版本系统，其预装的软件库、依赖包版本均无法适配Node.js 22这类较新的版本，导致构建时无法解析并安装指定的Node.js 22.*.*版本。

解决办法 #

• 升级构建环境版本：在Cloud Run的构建配置中，选择更新的系统环境镜像，比如ubuntu2204或debian12。这类新版本系统对Node.js 22有完整的支持，能正常解析并安装对应版本。
• 降低Node.js版本：修改项目根目录的package.json文件，添加或调整engines字段，指定ubuntu1804支持的Node.js版本（比如长期支持版的18..）：

  "engines": {
    "node": "18.*.*"
  }
  

  也可以在项目根目录创建.nvmrc文件，写入18来指定版本。
• 使用自定义Dockerfile：手动编写Dockerfile，指定兼容Node.js 22的基础镜像（比如node:22-alpine），完全控制构建环境，摆脱Cloud Run默认环境的限制。示例Dockerfile：

  FROM node:22-alpine
  WORKDIR /app
  COPY package*.json ./
  RUN npm install
  COPY . .
  RUN npm run build
  EXPOSE 3000
  CMD ["npm", "start"]
  

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