← ブログに戻る
Guide公開日 2026-02-12· 12 分で読了

Next.js で SaaS を構築する 2026 完全ガイド:認証・課金・AI まで

WangNan, author at Uncorne
著者 WangNan
発行 Uncorne · 更新 2026-10-21

2026 年做 SaaS,你依然要解决每个创始人都会撞上的那 60% 通用问题:注册、数据库、计费,以及登录后的页面。能交付的人和卡住的人,差别几乎不在创意,而在于多快停止重复造这 60% 的轮子,把一周的时间花在只有你能做的那部分上。

这篇指南是我今天会照着走的顺序:从空仓库到一个已部署、可计费的应用,并把最省时间的决策点标出来。我明确偏好 Next.js 与 Supabase,因为这套组合省掉的决策比它带来的更多;但底层的操作顺序适用于任何技术栈。

SaaS 工作中属于通用部分的 60% 与属于你产品的 40%
SaaS 工作中属于通用部分的 60% 与属于你产品的 40%

为什么通用的 60% 决定了谁能上线

任何一个 SaaS,从一个人的订阅通讯工具到团队协作分析产品,在第一个客户付钱之前都需要同样的主干:

  • 支持邮箱魔法链接与 OAuth 的登录鉴权,会话会轮换且可撤销。
  • 带行级安全的数据库,即使应用代码有 bug,一个租户也读不到另一个租户的数据行。
  • 订阅计费,并且用 Webhook 把支付商(而不是浏览器)当作真相来源。
  • 登录后的控制台,以及计费与个人资料交汇的设置页。
  • 一套部署方案:环境变量、数据库迁移、Preview 部署、自有域名。

这些都不是你的差异化优势。客户不会因为你的魔法链接登录写得特别优雅而选择你;他们选择你,是因为那 40%——你专门解决的那件事——比替代方案更好。但在现实中,这 60% 的通用工作会吃掉大多数独立项目最初的三到六周,相当一部分项目再也走不过去。

策略上的做法是:一次性交掉这笔过路费,用一套你读得懂、改得动的基础设施,然后永远不再想它。「读得懂、改得动」很关键:一个凌晨两点你无法调试的黑盒模板,比自己写登录更糟,因为它偏偏在你最没能力修的时候出问题。

选一套已经具备主干的技术栈

Next.js 15 配 App Router、TypeScript 与 Tailwind 成为默认,是有原因的。Next.js App Router 文档在一个框架里覆盖了服务端组件、Server Actions 与流式输出,人才池足够大,你能找到的几乎每一篇教程都默认这套栈。跟这个共识对着干,买不到任何好处。

数据库与登录方面,配上 Supabase:它给你 Postgres、邮箱与 OAuth 登录、存储,以及——最关键的一等公民特性——行级安全。RLS 是大家先跳过、后后悔的那一块。把租户隔离定义在数据库里,意味着应用代码里漏写一句 where userId = ?,也不会把数据跨账号泄露出去。

Next.js 15 加 Supabase 技术栈,覆盖登录、数据库与行级安全
Next.js 15 加 Supabase 技术栈,覆盖登录、数据库与行级安全

一个最小而诚实的目录结构长这样:

app/
  (marketing)/page.tsx        # 公开落地页
  (app)/dashboard/page.tsx    # 登录后的区域
  api/
    checkout/route.ts         # 创建计费会话
    webhooks/route.ts         # 校验并应用支付商事件
    ai/chat/route.ts          # 你唯一真实的功能,受套餐限制
lib/
  auth.ts                     # 会话辅助函数
  db.ts                       # Supabase 客户端 + 感知 RLS 的查询
  billing/
    types.ts                  # 与支付商无关的接口
    stripe.ts                 # 一个适配器
components/
supabase/migrations/          # schema + RLS 策略,纳入版本管理

由这个结构能推出两条规则。第一,任何会改动金钱或权限的逻辑都在服务端,绝不放进客户端组件。第二,迁移脚本进版本控制;数据库 schema 是代码,不是在后台点点拼出来然后忘掉的东西。

第一天就决定计费架构

计费是所有决策里「早做最便宜、晚改最贵」的那个。有两个问题要回答。

第一个是你要不要成为 merchant of record(记录商家)。如果你面向全球销售,却不是每个市场都有公司主体,像 Waffo Pancake 或 Lemon Squeezy 这样的 MoR 会替你代收代缴销售税与增值税。这是真实的运营节省,不是一句营销话术。如果你已经有 Stripe 账户和公司,Stripe 订阅给你更强的控制和规模下更低的费率,但税务合规要你自己扛。

第二个问题是你的代码是否被绑死在一家支付商上。成长中的产品常常为了新地区或更高转化率而接入第二家网关。如果创建结账和处理 Webhook 的逻辑散落在六个文件里,那次迁移就是重写。如果两者都收在一层很窄的接口后面——createCheckoutSession(plan, user) 与 normaliseEvent(raw)——那么新增一家支付商只是加一个适配器,而不是重做架构。

拿到这套主干的三种方式,务实对比如下:

| 方式 | 前期时间 | 你掌控的部分 | 痛点 | | --- | --- | --- | --- | | 全部自己写 | 3–6 周 | 全部 | 慢,而且通用代码仍然要维护 | | 买一套固定模板 | 1–2 天 | 只有你的应用代码 | 未选模块让包变臃肿;去品牌要手工做 | | 按配置生成 | 一个下午 | 模块、支付网关、AI 供应商、风格 | 你必须事先想清楚要什么 |

计费决策流程:Merchant of Record 对比直连 Stripe,收在同一契约之后
计费决策流程:Merchant of Record 对比直连 Stripe,收在同一契约之后

当选择已经明确时,我倾向于生成。Uncorne 的 Builder 让你选择登录、支付网关、AI 供应商、功能、部署目标与视觉风格,服务端只返回包含这些模块的 ZIP。CI 会下载 18 组代表性组合并逐个做类型检查,而且 ZIP 是白标的:营销页与生成器本身都会被剪掉,所以你交付的是你的产品,不是换了皮的模板。

把配置当作一等公民

演示与产品之间的差距,通常就是配置纪律。维护一个 .env.example,列出每一个变量并注释说明从哪里取值;缺了必填 key 时让应用启动即失败。静默回退——计费路由在生产环境悄悄用测试 key——正是订阅看起来一直正常、直到第一笔真实扣款失败才暴露的原因。

明确区分测试模式与生产模式的凭据。使用不同的 Stripe 测试 key 与生产 key、不同的 Webhook secret、为 Preview 部署使用不同的数据库 schema。一次 Preview 部署绝不应该能给真实客户发邮件或划走真钱。如果你的技术栈让这件事很难做到,现在就加护栏,而不是等事故之后。

把密钥挡在客户端包之外。在 Next.js 中,只有以 NEXT_PUBLIC_ 开头的变量会暴露给浏览器,其余都留在服务端。把支付密钥读进客户端组件不是捷径,而是凭据泄露。在 Server Action 或路由处理器里读取会话状态,正确做法是用 cookies API,这样会话令牌就不会落到浏览器里运行的 JavaScript 手中。

环境与部署纪律:每次部署分别使用测试与生产凭据
环境与部署纪律:每次部署分别使用测试与生产凭据

加上只属于你的那一个功能

这个阶段最常见的错误,是把演示堆得过满。创始人接了五个 AI 端点、三个控制台和一座设置迷宫,结果在任何一个功能被客户测试之前就没时间了。属于你的那 40% 不是「更多功能」,而是一个明显比替代方案更好的功能。

交付一个真实能力,放在登录与套餐权限之后。取决于你的产品,它可能是一个流式对话端点、针对客户自己文件的文档问答,或者一个摘要器。如果你要做检索,OpenAI 的 embeddings 指南和 Supabase 的 AI 文档详细覆盖了存储与搜索那一半。其余部分保持诚实的脚手架,配上清楚的 TODO,而不是一个假按钮。

有一条诚实的边界值得说清:原型不是生产级 AI 系统。流式错误、token 配额、供应商限流和提示注入,在你为这个功能收费之前都需要真正处理。坦白哪些是脚手架、哪些已完成,不是示弱——它让你能和用户一起迭代,而不是为演示辩护。

一个受套餐限制的 AI 功能,架在通用主干之上
一个受套餐限制的 AI 功能,架在通用主干之上

测试那些无聊的路径,而不只是顺利路径

计费集成的完成标准,是失败情况都被处理了,而不是顺利流程能跑通。上线前,把这些路径走一遍:一条签名错误的 Webhook 到达并返回 400;同一个事件 id 到达两次但只被应用一次;订阅被取消后套餐翻回;未登录用户访问结账路由被重定向到登录;免费用户调用 AI 端点返回 402。每一条花几分钟就能测,但如果等客户先撞上、你再调试,就要花几小时。

完整的验证闭环——签名校验、防重放、整套流程——写在如何给 Next.js 添加 Stripe 订阅里。重点不在 Stripe 的细节,而在于「无聊路径」是一份你要去执行的清单,不是一种凭感觉的东西。

让自己容易被找到,也容易交给智能体

一个没人发现、但能跑的应用,仍然是一次失败的发布。第一周两笔小投入,会在之后几个月持续回报。

第一笔是结构化数据。按照 schema.org 的定义和 Google 的结构化数据指南,在你的内容页输出 BlogPosting 与 FAQPage 的 JSON-LD。尤其是 FAQ 答案,应当能独立成为可引用的段落——答案引擎引用的是答案,不是问题。如果你用多种语言发布,按 Google 的国际化指南加上 hreflang 与本地化版本。

第二笔是智能体可读的文档。按 llms.txt 约定发布一个 llms.txt 文件,把智能体指向你真正的文档;并在仓库里保留一个 AGENTS.md,写明命令、架构与边界。这些写起来成本很低,却越来越决定一个 AI 助手能否第一次就正确接入你的产品。

发布清单上的结构化数据与智能体可读文档
发布清单上的结构化数据与智能体可读文档

先上线,再收费

顺序很重要。从免费或预览档起步,跑通一次测试结账,等客户真正获得价值后再收费。一个生成出来的应用,应该让你从选配置到一个已部署、可计费的系统只用一下午——而不是一个季度。

具体来说,第一周是这样:

  1. 配置并生成项目,提交到一个全新的仓库。
  2. 设置环境变量,跑迁移,确认 Preview 部署可用。
  3. 用魔法链接和 OAuth 登录,确认 RLS 挡住跨租户读取。
  4. 在测试模式跑一次结账,确认 Webhook 让数据库里的套餐翻转。
  5. 把那唯一一个真实功能放到套餐权限之后,交付给少数用户。
  6. 至少等一个用户会因为失去访问而懊恼时,再开始收费。
从生成到可计费部署的第一周清单
从生成到可计费部署的第一周清单

诚实的总结

那让产品成为你产品的 40%,没有捷径。但那 60%——登录、数据库、计费、控制台、部署——是一个又一个已被解决的问题,最快的创始人把它当收费站,而不是工地。选一套生态深厚的栈,在数据库里锁死租户隔离,把计费收在与支付商无关的接口之后,只做一个真实功能,并让你的文档对人和对智能体都易读。然后上线,让客户告诉你第二个功能应该是什么。

FAQ

Next.js で SaaS を作るのにどのくらいかかりますか?+

時間がかかるのは共通の土台(認証、データベース、課金、ダッシュボード)で、手作業なら三〜六週間かかります。生成テンプレートならこの部分は午後一の設定だけ。残りの時間はあなた自身の製品に使われ、テンプレートでは短縮できません。

Next.js で SaaS を作るのに Supabase は必須ですか?+

いいえ。Supabase は Postgres と行レベルセキュリティの有力な既定値ですが、Uncorne は SUPABASE_SERVICE_ROLE_KEY が設定されているかどうかで Supabase とローカル SQLite を切り替えます。SQLite はローカル開発向けで、ローカルの認証経路には MFA、OAuth、セッションローテーションがなく、serverless では永続しません。

最初にどの決済ゲートウェイを選ぶべきですか?+

各市場に法人がなく世界中で販売するなら、Waffo Pancake や Lemon Squeezy のような Merchant of Record が消費税処理を肩代わりします。すでに Stripe アカウントがあれば Stripe から始めてください。チェックアウトと Webhook をプロバイダ非依存の契約の後ろに置けば、後で切り替えるのは設定変更であり、書き直しではありません。

ボイラープレートは自作すべき、それとも生成すべき?+

共通レイヤー自体が差別化要因になる場合だけ自作してください。それはめったにありません。選択肢を事前に決められるなら生成が有利で、未選択モジュールを刈り取り、ブランドフリーの ZIP を出し、CI で代表的な組み合わせを型チェックします。固定テンプレートが有利なのは、要件が本当に汎用な場合だけです。

初日から AI 機能は必要ですか?+

いいえ。実際の機能は、顧客がすでに料金を払っている問題を解決するときだけ出荷してください。プロトタイプは本番の AI システムではありません。ストリーミングエラー、トークン割当、プロバイダのレート制限、プロンプトインジェクションは、課金前にきちんと処理する必要があります。明確な TODO 付きの正直な足場のほうが、中途半端に配線した五つの AI エンドポイントより優れています。

よくある質問をすべて見る · Markdown 版(AI エージェント向け)