使用 Vercel 部署 Node.js 应用

约 503 字大约 2 分钟

Node.js 工程化

2025-07-24

Vercel 是一个流行的云平台，特别适合前端项目的部署，它同样可以完美支持 Node.js 后端应用的部署。本文将详细介绍如何使用 Vercel 部署你的 Node.js 项目。

为什么选择 Vercel ？

简单易用：Vercel 提供了极其简单的部署流程
全球 CDN：自动部署到全球边缘网络
免费套餐：适合个人项目和小型应用
自动 HTTPS：无需额外配置
无缝集成：与 GitHub、GitLab 等完美集成

准备工作

在开始之前，你需要：

一个 Vercel 账号（可通过 GitHub 等账号直接登录）
一个可以部署的 Node.js 项目
项目代码托管在 GitHub、GitLab。

部署步骤

1. 创建简单的 Node.js 项目

以 express 创建的简单 Node.js 项目为例：

// app.js 入口文件
const express = require("express");
const app = express();

app.get("/", (req, res) => {
  res.send("Hello Vercel!");
});

module.exports = app;

// package.json 依赖配置
{
  "name": "vercel-node-example",
  "version": "1.0.0",
  "main": "app.js",
  "scripts": {
    "start": "node app.js"
  },
  "engines": {
    "node": ">=14.x"
  }
}

// vercel.json vercel配置文件
{
  "version": 2,
  "builds": [
    {
      "src": "index.js",
      "use": "@vercel/node" // 使用最新node环境
    }
  ],
  "routes": [
    // 匹配所有路由
    {
      "src": "/(.*)",
      "dest": "index.js"
    }
  ]
}

2. 通过 GitHub 集成部署

将项目推送到 GitHub 仓库
登录 Vercel 控制台
点击 "New Project"
选择你的 GitHub 仓库
配置项目设置（保持默认即可）
点击 "Deploy"

常见问题解决

1. 部署后出现 404 错误

确保你的 vercel.json 配置正确，特别是 routes 部分指向了正确的入口文件。

2. 环境变量不生效

确保环境变量名称拼写正确
重新部署项目以使环境变量生效
检查是否添加到了正确的环境（生产/预览）

3. 部署时间过长

缺少 vercels.json 文件
考虑使用更小的依赖项

4. 访问速度慢

添加自定义域名，并通过 Cloudflare 进行转发。