求助：NX Monorepo中Express应用免费部署方案及步骤

Netlify主打静态站点部署，直接套用React的部署方式跑Express API会因为运行环境不匹配出错。推荐用Render作为免费部署平台，它原生支持Node.js服务，配置简单，适合低流量的API服务。

前置准备 #

• 确认你的Express API在NX Monorepo中可以独立编译和运行：本地执行nx build api，生成的产物默认在dist/apps/api目录，执行node dist/apps/api/main.js能正常启动服务。
• 修改Express代码，确保监听process.env.PORT（Render会自动分配端口，不能硬写固定端口）：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`API running on port ${port}`);
  });
  

• 根目录package.json中添加便捷脚本（可选，但能简化部署配置）：

  "scripts": {
    "build:api": "nx build api",
    "start:api": "node dist/apps/api/main.js"
  }
  

部署到Render的步骤 #

1. 创建Web服务
   • 登录Render控制台，点击「New」按钮，选择「Web Service」。
   • 关联你的Git仓库（支持GitHub/GitLab/Bitbucket），选中包含NX Monorepo的仓库。
2. 配置构建与启动参数
   • Build Command：根据包管理器选择对应命令，比如用npm就填npm install && npm run build:api；用pnpm则填pnpm install && pnpm run build:api。
   • Start Command：填npm run start:api（如果之前配置了脚本），或者直接指向编译文件node dist/apps/api/main.js。
   • Environment Variables：添加API依赖的环境变量（比如数据库连接串、密钥等），按需填写即可。
   • Root Directory：如果API代码不在仓库根目录（比如嵌套在apps/api），可以指定该路径，默认留空用根目录即可。
3. 选择免费计划
   • 在「Plan」选项中选择「Free」，确认所有配置后点击「Create Web Service」。
4. 验证部署结果
   • Render会自动执行构建、启动流程，完成后会分配一个专属域名。访问该域名加上你的API路由（比如https://your-api-domain.onrender.com/api/items），确认能正常返回数据。

额外提示 #

• Render的免费服务会在15分钟无访问时休眠，下次请求会触发冷启动，适合开发测试或低流量场景。
• 如果构建时遇到包版本问题，可以在环境变量中指定NODE_VERSION，比如18.x，确保和本地开发环境一致。

内容的提问来源于stack exchange，提问作者Zsombor Horváth