认证系统

Better Auth 配置、登录方式和会话管理

概览

项目使用 Better Auth 作为认证框架。

• 配置位置: packages/lib-server/src/auth/auth.ts
• 插件目录: packages/lib-server/src/auth/plugins/

支持的登录方式

Better Auth 插件

项目使用了以下 Better Auth 插件：

• admin — 管理员角色和权限
• magic-link — 邮件魔法链接登录
• openAPI — 自动生成认证相关 OpenAPI 文档
• organization — 组织管理（角色、邀请）
• phone-number — 手机号登录
• two-factor — 双因素认证
• username — 用户名支持

自定义插件：

• invitation-only — 仅邀请注册模式
• wechat-oauth — 微信 OAuth 登录

微信 OAuth 流程

1. PC 端：展示微信二维码 → 用户扫码 → 回调获取 code → 换取 access_token → 获取用户信息
2. 手机端：微信内打开 → 静默授权 → 获取 code → 换取用户信息

配置环境变量：

WECHAT_APP_ID="your-wechat-app-id"
WECHAT_APP_SECRET="your-wechat-app-secret"

会话管理

Better Auth 使用数据库存储 session，相关模型：

• Session — 会话记录
• Account — OAuth 账号关联
• Verification — 验证令牌

在 API 路由中使用

// 获取当前登录用户
const session = c.get("session");
const user = c.get("user");

if (!user) {
  return c.json({ error: "Unauthorized" }, 401);
}

客户端检查登录状态

import { authClient } from "@/lib/auth-client";

// 获取当前会话
const { data: session } = await authClient.getSession();

// 检查是否登录
if (session?.user) {
  // 已登录
}

组织与角色

通过 Better Auth 的 organization 插件管理：

• 创建组织（社区分部）
• 邀请成员加入
• 角色分配：owner、admin、member