Google App Engine Node.js应用能否在不同目录安装独立node_modules？

我的MEVN栈应用目录结构如下：

app
   - server
      - dist
      - node_modules
      package.json
      package-lock.json
   - client
      - dist
      - node_modules
      package.json
      package-lock.json
   app.yaml
   package.json
   package-lock.json

我希望运行gcloud app deploy时，GAE能自动为server和client两个子目录安装生产依赖，但遇到两个障碍：

• GAE文件系统只读，无法手动在子目录执行依赖安装命令，会报错；
• 在根目录app的package.json里把client和server列为依赖，虽然能安装所有依赖，但生成的node_modules在根目录，导致server和client无法访问各自的依赖。

我不想分开部署两个GAE实例，求单实例下的解决办法。

解决方案 #

方法1：利用根目录package.json的预处理脚本 #

在根目录的package.json中添加preinstall脚本，利用GAE安装根依赖前的可写文件系统时机，为子目录安装依赖：

{
  "scripts": {
    "preinstall": "cd server && npm install --production && cd ../client && npm install --production",
    "start": "node server/dist/index.js"
  }
}

同时修改app.yaml指定启动命令：

runtime: nodejs20
entrypoint: npm start

GAE会优先执行preinstall脚本，此时文件系统还未变为只读，能顺利完成子目录的依赖安装。

方法2：调整子应用的依赖查找路径 #

如果不想修改安装流程，可让子应用从根目录的node_modules加载依赖：

• 在server的入口文件顶部添加：

const path = require('path');
require('module').globalPaths.push(path.join(__dirname, '../../node_modules'));

• 在client的构建配置（如vue.config.js）中修改依赖解析路径：

const path = require('path');
module.exports = {
  configureWebpack: {
    resolve: {
      modules: [path.resolve(__dirname, '../../node_modules'), 'node_modules']
    }
  }
};

这种方式不需要改动安装步骤，只需调整代码的依赖查找逻辑。

方法3：使用自定义Docker镜像部署 #

如果需要完全掌控部署流程，可改用GAE自定义运行时，通过Dockerfile实现：

1. 在根目录创建Dockerfile：

FROM node:20-alpine
WORKDIR /app

# 先复制package文件以利用Docker缓存
COPY server/package*.json ./server/
RUN cd server && npm install --production

COPY client/package*.json ./client/
RUN cd client && npm install --production

# 复制所有应用代码
COPY . .

# 启动服务
CMD ["node", "server/dist/index.js"]

2. 修改app.yaml切换到自定义运行时：

runtime: custom
env: flex

这种方式灵活性最高，适合复杂的多子应用场景，但需要维护Dockerfile。

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