部署
Vercel
在 Vercel 上通过 Serverless Functions 部署 MuseMVP。
本指南指导您如何将 MuseMVP 部署到 Vercel。
配置流程
导入代码仓库
登录 Vercel 后，在主界面选择 Add New Project，选择对应的 Git 提供商并授权导入您的仓库。
构建配置
Build and Output Settings保持默认配置即可，无需修改。- 环境变量注入
导入本地的 .env 文件即可
环境变量说明
除了 DATABASE_CONNECTION_STRATEGY 之外，其他环境变量在本地 .env 文件中都有说明 快速构建 / 环境变量，直接导入即可。
DATABASE_CONNECTION_STRATEGY="database_url_first"关于数据库连接策略
设置 DATABASE_CONNECTION_STRATEGY=database_url_first 是固定的，程序会在初始连接阶段使用标准方式直连数据库。
问题排查
绝大多数部署异常来自环境变量缺失或配置错误，排查时优先检查此项。
Node 版本引发构建打包错误
前往 Project Settings → Node.js Version，手动指定为 22.x。
后端 API 接口超时断开
在 vercel.json 中为 src/app/api/**/* 路由增加 maxDuration 秒数配置。
登录后 Session 丢失立即退出
属于跨域 Cookie 写入失败，检查 NEXT_PUBLIC_SITE_URL 是否与实际访问域名完全一致。
如果尝试以上步骤后问题依然存在，请深入查看 Vercel 部署日志以获取更多信息。