SuperAPI AI 工具集

better-auth

编程与开发

查看项目

更新于 10-16 01:31

技能介绍

用途:把 better-auth 认证库集成进 Next.js 16 应用,覆盖邮箱/密码、社交 OAuth、魔法链接、Passkey 与 2FA 等认证方式,并处理 Prisma/Drizzle 等数据库适配器与 Next.js 16 的破坏性变更。

主要能力:提供安装配置、API 路由搭建、数据库 schema 生成、会话管理、各类认证方法与自定义 UI 表单的实现指引,同时列出常见错误的成因与修复办法。

必要用法:先安装 npm install better-auth;创建 lib/auth.ts、lib/auth-client.ts 与 app/api/auth/[...all]/route.ts;运行 npx @better-auth/cli generate;再执行 npx prisma db push(或 drizzle 等价命令);Next.js 16 下用 proxy.ts 做路由保护。Next.js 16 中 middleware.ts 改为 proxy.ts,导出 middleware 改为 proxy,headers()、params、searchParams 均需 await,proxy 不支持 edge runtime,可用 npx @next/codemod@latest middleware-to-proxy . 迁移。

限制与注意:AUTH_SECRET 必须 32 位以上;服务器端用 auth.api.getSession({ headers: await headers() });邮件发送需自行实现;所有密钥存环境变量;加插件后须重跑 CLI generate;生产环境启用邮箱验证并使用 HTTPS。资料未提供具体价格与收费信息。