关于 better-auth-integrations
用于将 Better Auth 处理器接入 Web 框架的技能,提供 Next.js App Router 和 Pages Router 示例,重点说明路由配置及 SSR、服务器操作中的 Cookie 和请求头处理。
主要功能
- 01在认证路由挂载处理器
- 02使用框架专用处理辅助函数
- 03配置 Next.js App Router 和 Pages Router
- 04处理服务器操作中的 Cookie
- 05统一服务端与客户端基础路径
适用场景
- 01为 Next.js 应用添加 Better Auth 路由
- 02配置服务器操作中的认证处理
- 03避免 Cookie 和请求体解析器集成问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bobmatnyc/ claude-mpm-skills --skill better-auth-integrations安装后在 Claude Code 中输入/better-auth-integrations确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
metadata.jsonreferences/frameworks.mdnextjs.md详细介绍
Better Auth 集成
目标
- 将 Better Auth 处理器挂载到
/api/auth/*(或自定义基础路径)。 - 在可用时使用框架辅助工具。
- 确保在 SSR 和服务器操作中 Cookie 与标头能够正确传递。
快速开始
- 创建一个
auth实例(参见better-auth-core)。 - 为
/api/auth/*添加一个全匹配路由。 - 使用框架辅助工具(或
auth.handler)返回 Response。
Next.js App Router
import { auth } from "@/lib/auth";
import { toNextJsHandler } from "better-auth/next-js";
export const { GET, POST } = toNextJsHandler(auth);
Next.js Pages Router
import { auth } from "@/lib/auth";
import { toNodeHandler } from "better-auth/node";
export const config = { api: { bodyParser: false } };
export default toNodeHandler(auth.handler);
在 Next.js 服务器操作中处理 Cookie
使用 nextCookies 插件,以便服务器操作正确设置 Cookie。
import { betterAuth } from "better-auth";
import { nextCookies } from "better-auth/next-js";
export const auth = betterAuth({
// ...config
plugins: [nextCookies()],
});
注意事项
- 确保服务器端和客户端的基础路径一致。
- 在可用时优先使用框架辅助工具。
- 避免在认证处理器之前运行自定义正文解析器。
参考资料
toolchains/platforms/auth/better-auth/better-auth-integrations/references/nextjs.mdtoolchains/platforms/auth/better-auth/better-auth-integrations/references/frameworks.md
评论
支持 Markdown