将Next.js 13应用部署至GCP App Engine时遇两类问题求助

问题1：Error: ENOENT: no such file or directory, mkdir '/workspace/.next' #

原因 #

部署流程中Next.js无法在指定路径创建.next目录，通常是构建阶段未正确执行next build，或是App Engine环境的路径配置、权限存在问题。

解决方案 #

• 明确构建步骤：确保package.json的脚本包含正确的构建命令：

  "scripts": {
    "build": "next build",
    "start": "next start"
  }
  

  若使用Cloud Build自定义构建流程，需在cloudbuild.yaml中补充构建步骤：

  steps:
    - name: 'node:18'
      args: ['npm', 'install']
    - name: 'node:18'
      args: ['npm', 'run', 'build']
  

• 启用独立构建模式：修改next.config.js开启独立输出，减少路径依赖问题：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    output: 'standalone',
    experimental: {
      appDir: true
    }
  }
  module.exports = nextConfig
  

  同时将start命令改为node .next/standalone/server.js，避免启动时的路径错误。
• 权限排查：标准环境下App Engine运行用户默认拥有目录创建权限，无需手动调整；灵活环境需确认app.yaml未限制目标目录的访问权限。

问题2：冷启动提示："This request caused a new process to be started..." #

原因 #

这是App Engine标准环境的默认机制：实例闲置一段时间后会被自动回收，新请求触发时需重新启动实例，从而产生冷启动延迟。

解决方案 #

• 配置最小实例数：在app.yaml中设置自动缩放参数，保持至少一个实例持续运行：

  automatic_scaling:
    min_instances: 1
  

• 启用暖请求：在app.yaml中添加暖up服务配置，让实例提前完成初始化：

  inbound_services:
    - warmup
  

  Next.js会自动响应/_ah/warmup路由，无需额外编写处理逻辑。
• 优化启动速度：使用上述独立构建模式，减少启动时加载的文件体积，缩短实例启动耗时。

内容的提问来源于stack exchange，提问作者Abdulsalam Al Mahdi