用途：Better Auth 是面向 TypeScript 项目的身份认证框架，用于为 Web 应用添加登录、会话与权限管理，支持 Cloudflare D1、Next.js、Nuxt 等 15+ 框架。
主要能力：邮箱密码登录、45+ 社交登录提供商、会话管理、受保护 API 路由、多租户组织、双因素认证、Passkey、SSO（OIDC/OAuth2/SAML 2.0）、API Key、i18n、Electron 桌面端认证等。v1.5.0 起原生支持 D1，可直接传入 D1 绑定；复杂 schema 建议配合 Drizzle ORM 或 Kysely。
使用方式：安装 better-auth 及适配器，例如 bun add better-auth drizzle-orm drizzle-kit；v1.4.0+ 为 ESM-only，需在 package.json 设置 "type": "module"。创建 D1 数据库 wrangler d1 create my-app-db，定义 schema 后初始化 betterAuth，并在 Worker 中挂载 /api/auth/* 路由。部署前执行 bunx drizzle-kit generate 与 wrangler d1 migrations apply my-app-db --remote，再 wrangler deploy。密钥通过 wrangler secret put 设置 BETTER_AUTH_SECRET。
限制与注意：不存在 d1Adapter，应使用 drizzleAdapter 或 Kysely；schema 列名需用 camelCase；CORS 需配置 credentials: true；OAuth 回调 URL 必须完全匹配。v1.5.0 与 v1.6.0 存在破坏性变更，升级需参考对应迁移指南。具体 API 与代码示例以官方文档为准。