用途:Lucia Auth 是服务端会话(session-based)认证库,抽象会话管理与 Cookie 处理,适合构建自定义认证系统。
主要能力:通过数据库适配器(Prisma、Drizzle、SQLite/better-sqlite3、MongoDB)管理用户与会话;提供 createSession、validateSession、invalidateSession、invalidateUserSessions、createSessionCookie、createBlankSessionCookie 等 API;支持会话过期时间(TimeSpan)与 Cookie 属性(secure、sameSite)配置;可配合 @node-rs/argon2 做密码哈希与校验,配合 arctic 实现 GitHub 等 OAuth 流程,并支持密码重置流程。
使用方式:安装 npm install lucia 及对应适配器(如 npm install @lucia-auth/adapter-prisma),在 lib/auth.ts 中创建 Lucia 实例并配置适配器、会话过期与 Cookie;在注册、登录、登出、会话校验等流程中调用相应方法。框架集成示例覆盖 Next.js App Router、Express、Hono,并给出 CSRF 校验中间件写法。
适用场景:需要服务端会话管理、Cookie 会话、OAuth 登录、密码重置的 Web 应用。
限制:资料明确说明 Lucia v3 将于 2025 年 3 月弃用,但其中会话认证模式仍有效;具体收费、价格、平台支持范围等资料未提供。