Vercel

本文档将帮助您将项目部署到 Vercel 平台。由于项目是使用 Next.js 构建的，Vercel 作为 Next.js 的创建者，提供了最佳的开发者体验和性能优化。

前提条件

在部署项目之前，请确保您有：

包含项目代码的 Git 仓库（如 GitHub）
Vercel 账户，如果您没有，请在这里注册
为生产环境配置的环境变量

部署步骤

将代码推送到 Git 仓库

确保代码已推送到 GitHub、GitLab 或 Bitbucket 上的代码仓库。

连接到 Vercel

登录到 Vercel 控制台
点击 Add New Project 或 New Project 按钮
导入 Git 仓库

配置新项目

在配置页面上，您需要设置以下选项：

Framework Preset：选择 Next.js
Build Command：使用默认的 npm run build（如果使用 pnpm，则为 pnpm build）
Output Directory：使用默认的 .next
Install Command：使用默认的 npm install（如果使用 pnpm，则为 pnpm install）

如果您不确定某个设置，可以保持默认值。Vercel 通常会自动检测正确的配置。

配置环境变量

在配置页面上，找到 Environment Variables 部分

添加所有必要的环境变量，例如：

NEXT_PUBLIC_BASE_URL="https://your-domain.com"
DATABASE_URL="your_database_URL"
BETTER_AUTH_SECRET="your_better_auth_secret_key"
RESEND_API_KEY="your_resend_api_key"

确保添加运行项目所需的所有环境变量
确保环境变量为生产环境配置

部署项目

点击 Deploy 按钮开始部署过程。Vercel 将自动构建和部署项目。

重要环境变量：NEXT_PUBLIC_BASE_URL

NEXT_PUBLIC_BASE_URL 环境变量用于设置应用程序的基础 URL。

如果您要部署到自定义域名，您需要按照自定义域名部分的步骤将 NEXT_PUBLIC_BASE_URL 环境变量设置为自定义域名。然后在部署成功后使用自定义域名访问您的应用程序。

如果您没有自定义域名，可以使用 Vercel 提供的域名。例如，如果您的项目部署到 https://your-project.vercel.app，您需要将 NEXT_PUBLIC_BASE_URL 环境变量设置为 https://your-project.vercel.app。

但是 Vercel 提供的域名在成功部署后才可用，所以您需要在部署成功后将 NEXT_PUBLIC_BASE_URL 环境变量设置为 Vercel 提供的域名。然后重新部署项目以使环境变量生效。之后，您可以使用 Vercel 提供的域名访问您的应用程序。

自定义域名

如果您想为项目添加自定义域名：

在 Vercel 控制台中进入到项目设置
导航到 Domains 部分
添加自定义域名
按照 DNS 配置说明操作

更新环境变量

你可以在 Project Settings > Environment Variables 中添加或更新环境变量，然后重新部署项目。

自动部署

Vercel 在以下情况下提供自动部署功能：

推送代码到主分支
创建新的 Pull Request
推送到启用预览部署的分支

每个 Pull Request 都会获得一个唯一的预览 URL，允许您在合并到生产之前测试更改。

常见问题

构建失败

如果构建过程失败：

检查构建日志以获取详细的错误信息
确保所有依赖项都正确安装
验证环境变量是否正确配置

应用程序功能不正确

确认所有环境变量都正确设置
检查数据库连接是否正常工作
验证第三方服务的 API 密钥是否有效
检查日志中是否有任何错误或消息，这些可以帮助您诊断问题