Agent Skills
返回列表
💻

Vercel 存储选型

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-vercel-plugin-vercel-storage。

技能介绍

要解决什么问题

在 Vercel 上接数据库、缓存或文件存储时,产品版图并不静止:@vercel/postgres、@vercel/kv 已下架,Marketplace 里的 Neon、Upstash 与第一方 Vercel Blob、Edge Config 分工各异。若仍按旧文档装包,或在 Edge Config 里塞会话状态,轻则构建失败,重则鉴权链路静默挂起。

技能如何帮你选型与落地

技能按 Marketplace 优先、CLI/手工兜底 的路径排序:优先 vercel integration add ... 或控制台集成,让账号、资源与环境变量自动注入关联项目;仅在 Marketplace 不可用或必须用既有外部账号时,才走手工开通,并自行同步环境变量后执行 vercel env pull .env.local --yes。

第一方能力上,Blob 面向图片、视频、文档等非结构化数据;access: 'private' 适用于不可公开访问的对象,需用 get() 读取,勿把需 CDN 公网分发的资源设为 private。Edge Config 是边缘只读 KV,适合功能开关、A/B 配置、维护模式;不适合用户数据或高频写入。Marketplace 侧涵盖 Neon Postgres(@neondatabase/serverless,Node.js 19+)、Upstash Redis、Supabase、Prisma、MongoDB Atlas、Convex、Turso 等,并附带 Storage Decision Matrix 与从 @vercel/postgres → Neon、@vercel/kv → Upstash 的迁移要点。

边界与踩坑

Neon 在构建期若顶层直接 neon() 且 DATABASE_URL 未配置会导致 Next.js build 崩溃;应用 lazy 初始化(如 getDb()),且 不要用 JavaScript Proxy 包装 DB 客户端——NextAuth/Auth.js 会探测 adapter 对象属性,Proxy 会导致请求链挂起且无报错。跑 drizzle-kit、tsx 等脚本时不会自动加载 .env.local,需手动 dotenv 或导出变量。Neon CLI 兜底场景下,Vercel 托管项目往往还需要 Neon API key,不能单靠浏览器登录。

使用场景

  • 首次在 Vercel 部署 Next.js 应用,需决定用 Blob 存用户上传还是用 Neon 存业务表数据
  • 维护仍引用 @vercel/postgres 的旧项目,要按文档迁移到 Marketplace Neon 并避免构建期 DATABASE_URL 报错
  • 在边缘实现功能开关与 A/B 路由配置,需确认 Edge Config 与 Upstash Redis 各自该存什么
  • 通过 CLI 手工创建 Neon 项目后,要在本地 drizzle-kit 迁移前正确加载 Vercel 注入的数据库环境变量

适合人员

  • 负责 Vercel 全栈项目的工程师,需要在一次迭代里对齐存储选型与 Marketplace 开通顺序
  • 接手含 NextAuth 的代码库的全栈开发,排查数据库懒加载与 Proxy 包装导致的鉴权无响应问题
  • 写部署与运维文档的 DevOps,要区分已下架 @vercel/kv 与当前 Upstash Redis 集成方式
  • 在 Vercel Marketplace 上评估 Supabase、Prisma、Turso 等非默认方案的技术负责人