authboss 是 go 语言中广受欢迎的轻量级身份认证框架，但默认仅支持内存存储；本文详解如何通过自定义 storer 接口将其对接 mysql、postgresql 等关系型数据库，实现服务重启不丢用户、高可用的生产级认证方案。
authboss 是 go 语言中广受欢迎的轻量级身份认证框架，但默认仅支持内存存储；本文详解如何通过自定义 storer 接口将其对接 mysql、postgresql 等关系型数据库，实现服务重启不丢用户、高可用的生产级认证方案。
Authboss 的核心设计理念是“可插拔存储”（pluggable storage）——它不绑定任何具体数据库，而是通过统一的 Storer 接口抽象数据操作。这意味着，只要实现该接口的 CreateUser, FindUserByEmail, UpdateUser, DeleteUser 等方法，即可无缝接入任意持久化后端。
以下是一个基于 PostgreSQL（使用 pgx 驱动）的最小可行 Storer 实现示例：
type PGXStorer struct {
db *pgxpool.Pool
}
func (s *PGXStorer) CreateUser(ctx context.Context, user *authboss.User) error {
_, err := s.db.Exec(ctx, `
INSERT INTO users (email, encrypted_password, confirmation_token, confirmed_at, created_at, updated_at)
VALUES ($1, $2, $3, $4, NOW(), NOW())
`, user.Email, user.EncryptedPassword, user.ConfirmationToken, user.ConfirmedAt)
return err
}
func (s *PGXStorer) FindUserByEmail(ctx context.Context, email string) (*authboss.User, error) {
var u authboss.User
err := s.db.QueryRow(ctx, `
SELECT email, encrypted_password, confirmation_token, confirmed_at, created_at, updated_at
FROM users WHERE email = $1
`, email).Scan(
&u.Email,
&u.EncryptedPassword,
&u.ConfirmationToken,
&u.ConfirmedAt,
&u.CreatedAt,
&u.UpdatedAt,
)
if errors.Is(err, pgx.ErrNoRows) {
return nil, authboss.ErrUserNotFound
}
return &u, err
}
// 其余方法（UpdateUser、DeleteUser、FindUserByConfirmToken 等）同理实现...
完成 Storer 后，在初始化 Authboss 时传入即可：
ab := authboss.New()
ab.Config.Storage.Server = &PGXStorer{db: pool} // pool 为已初始化的 pgxpool.Pool
ab.Config.Storage.Session = &PGXStorer{db: pool} // Session 存储也可复用（或单独用 Redis）
ab.Config.Core.Paths.Root = "/auth"
// ... 其他配置
if err := ab.Init(); err != nil {
log.Fatal(err)
}
⚠️ 注意事项：
- Authboss 不自动建表，需手动执行 SQL 创建 users 表（含 email, encrypted_password, confirmation_token, confirmed_at, created_at, updated_at 等字段），并确保 email 唯一索引；
- 密码字段建议使用 CHAR(60)（兼容 bcrypt 哈希长度），确认令牌建议 VARCHAR(128)；
- 生产环境推荐将 Session 存储分离至 Redis（实现 authboss.SessionStorer 接口），以提升并发性能与会话可靠性；
- 若需 OAuth2、多因子认证等高级功能，可考虑 qor/auth（GORM 集成度高）或商业方案如 Auth0（提供 SDK 和托管服务）。
综上，Authboss 并非“仅限内存”，其灵活性正体现在对存储层的彻底解耦。掌握 Storer 接口开发，你就能将它深度融入现有数据库架构，兼顾简洁性与工程健壮性。
