WHAT - NextAuth 权限认证机制

文章目录NextAuth 能解决什么问题支持哪些登录方式OAuth 登录用户名密码登录Email Magic LinkNextAuth 的核心概念1. Session2. JWT3. AdapterNext.js App Router 中的使用方式NextAuth 的优点开发效率高安全Next.js 集成好NextAuth 的缺点配置复杂与 Next.js 绑定较深与其他方案对比总结NextAuth.js现在已并入Auth.js项目是一个专门为 Next.js 提供的身份认证Authentication解决方案用来快速实现登录、会话管理和权限控制。官方文档Auth.js 官方文档NextAuth 能解决什么问题在 Web 应用中用户登录涉及很多复杂工作用户身份验证AuthenticationSession 管理JWT Token 管理OAuth 登录Google、GitHub 等登录状态持久化权限控制RBAC安全防护CSRF、Cookie 安全等如果自己实现需要写大量代码而 NextAuth 帮我们封装好了这些能力。支持哪些登录方式OAuth 登录最常见GitHubGoogleDiscordFacebookMicrosoftApple例如signIn(github)用户点击后直接跳转 GitHub 授权登录。用户名密码登录通过 Credentials ProviderCredentials({credentials:{username:{},password:{},},asyncauthorize(credentials){constuserawaitlogin(credentials)if(!user)returnnullreturnuser}})适合企业内部系统SaaS 平台自建用户体系Email Magic Link无需密码输入邮箱 ↓ 收到邮件 ↓ 点击链接 ↓ 自动登录适合ToC 产品AI 产品社区网站NextAuth 的核心概念1. Session登录成功后constsessionawaitauth()返回{user:{name:Tom,email:tomgmail.com}}Session 相当于当前用户状态。2. JWT默认可以使用 JWT 保存登录状态session:{strategy:jwt}优点无状态不依赖数据库适合 Serverless3. Adapter如果要把用户信息存数据库NextAuth ↓ Adapter ↓ Prisma ↓ PostgreSQL常见 AdapterPrismaMongoDBPostgreSQLMySQLNext.js App Router 中的使用方式Next.js 13 推荐// auth.tsimportNextAuthfromnext-authimportGitHubfromnext-auth/providers/githubexportconst{handlers,auth,signIn,signOut}NextAuth({providers:[GitHub]})API Routeexportconst{GET,POST}handlers服务端获取用户constsessionawaitauth()客户端登录button onClick{() signIn(github)} Login /buttonNextAuth 的优点开发效率高不用自己实现CookieSessionOAuth 流程安全内置CSRF ProtectionSecure CookiesOAuth 安全流程Next.js 集成好支持App RouterServer ComponentsMiddlewareEdge RuntimeNextAuth 的缺点配置复杂刚接触时会遇到callbacks session jwt adapter provider middleware概念较多。与 Next.js 绑定较深虽然现在升级为 Auth.js但历史上 NextAuth 与 Next.js 耦合较强。与其他方案对比方案适用场景NextAuth/Auth.jsNext.js 项目首选Clerk开箱即用功能丰富Supabase Auth已使用 SupabaseFirebase AuthGoogle 生态Auth0企业级认证自研 JWT简单项目、定制需求总结NextAuthAuth.js就是 Next.js 生态里最流行的认证框架负责帮开发管理“用户登录、会话、OAuth 授权和权限控制”让开发者不用从零实现认证系统。后面我们将进一步讲解 NextAuth 的整体架构Provider → Callback → JWT → Session → Middleware以及它的登录流程源码是怎么工作的。