buffalo 框架不内置 oauth 扩展，需手动集成 goth 库：先引入依赖，再在 app.go 注册 provider，最后定义 /auth/{p}/begin 和 /auth/{p}/callback 路由并启用 session 中间件。
Buffalo 框架本身不内置 OAuth 扩展
Buffalo 是一个 Go Web 框架，设计目标是“开箱即用但不过度封装”，它没有像 Nextend Social Login（WordPress）那样预装 OAuth 插件。你无法通过 buffalo generate oauth 或类似命令一键添加——它压根没提供这个子命令。
实际做法是：手动集成通用 OAuth 库，最常用、维护活跃的是 goth。它支持 GitHub、Google、Twitter、GitLab 等主流 provider，且与 Buffalo 的中间件机制兼容良好。
用 goth 实现 Buffalo OAuth 登录的三步核心操作
不是“安装扩展”，而是把 goth 作为依赖引入，并在 Buffalo 的请求生命周期中注入认证逻辑：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 运行
go get github.com/markbates/goth（注意：v1.90+ 版本已弃用旧版goth/gothic，改用goth+ provider 包） - 在
app.go初始化阶段注册 provider，例如：goth.UseProviders( github.New("your-client-id", "your-client-secret", "http://localhost:3000/auth/github/callback"), ) - 手动定义两个路由：
/auth/{provider}/begin（重定向到第三方授权页）和/auth/{provider}/callback（接收 code 并换 token），并在 callback 中调用goth.CompleteUserAuth(r)获取用户信息
常见错误：回调地址 404 或 state mismatch
Buffalo 默认使用 http://localhost:3000 作为开发地址，但 GitHub/GitLab 等平台对 redirect_uri 校验极严。容易踩的坑包括：
- 在 provider 初始化时写错回调路径，比如漏掉
/callback后缀，导致返回时 404 - 没在 Buffalo 的
App().Use()中启用 session 中间件（coke.SessionSaver()），goth依赖 session 存储state参数，缺失会导致oauth2: state did not match - 生产环境未替换
localhost为真实域名，且未在 OAuth 平台后台同步更新Authorization callback URL
为什么不用 authboss 或 gologin？
它们功能更重，适合需要完整登录页、密码策略、邮件验证的场景。而 Buffalo 项目通常倾向轻量组合：
-
goth只管 OAuth 流程，不侵入模板或数据库层，和 Buffalo 的render+pop组合自然 -
authboss强制要求实现User接口并绑定邮箱字段，如果你只想要“点一下 GitHub 登录就进首页”，反而要删一堆默认逻辑 -
gologin已多年未更新，对 Go 1.21+ 的泛型支持不完整，goth目前由 Buffalo 社区核心成员维护，适配更及时
真正卡住的往往不是代码怎么写，而是 provider 后台配置和本地开发域名的一致性——哪怕多一个斜杠，OAuth 就会静默失败。
