Buffalo 不支持内置 API 签名验证，需手动实现中间件：读取并重置 request body，从 header 提取签名与时间戳，按规范拼接参数计算 HMAC-SHA256，校验时间窗口及签名有效性。
Buffalo 没有内置 API 请求签名验证机制。它默认不提供类似 HMAC-SHA256 时间戳+密钥签名的校验能力，所有签名逻辑必须手动实现——这不是配置开关能打开的功能，而是要自己写中间件、解析 header、校验时间窗口和签名值。
为什么 Buffalo 不直接支持签名验证
Buffalo 的设计重心在全栈 Web 应用（含模板渲染、CSRF、session、asset 构建），它的中间件体系面向浏览器请求，csrf.New()、cookies.Secure() 这类中间件默认假设客户端是带 cookie 和表单的浏览器。而 API 签名验证需要：
- 从
Authorization或自定义 header（如X-Signature）里提取签名字符串 - 读取原始 request body（注意：Buffalo 的
c.Request.Body可能已被中间件提前读取并关闭） - 按约定拼接 timestamp + nonce + method + path + body hash，再用 secret key 计算 HMAC
- 强制校验 timestamp 是否在 5 分钟窗口内，防止重放
这些步骤 Buffalo 都不预置，也不封装成可复用的 VerifySignature() 函数。
如何手写签名验证中间件
你需要在 app.go 中注册一个自定义中间件，核心是确保 body 可重复读、签名逻辑不依赖模板或 session。示例关键点：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 用
io.NopCloser(bytes.NewReader(buf))把已读 body 重置回c.Request.Body - 签名计算时统一用小写 method、规范化的 path（无 trailing slash）、body 的 SHA256 hex（空 body 用空字符串）
- 从环境变量读
API_SECRET_KEY，别硬编码 - 校验失败直接调
c.AbortWithStatusJSON(401, map[string]string{"error": "invalid signature"})
代码片段示意：
func SignatureAuth() buffalo.MiddlewareFunc {
return func(c buffalo.Context) error {
secret := os.Getenv("API_SECRET_KEY")
if secret == "" {
return errors.New("API_SECRET_KEY not set")
}
// 读 body 一次并暂存
buf, err := io.ReadAll(c.Request().Body)
if err != nil {
return err
}
defer io.Copy(io.Discard, bytes.NewReader(buf))
// 重置 Body 供后续 handler 使用
c.Request().Body = io.NopCloser(bytes.NewReader(buf))
// 提取 header
sig := c.Request().Header.Get("X-Signature")
ts := c.Request().Header.Get("X-Timestamp")
// ... 校验 ts 是否在 5min 内，sig 是否匹配 HMAC-SHA256(...)
if !valid {
return c.Error(401, errors.New("signature verification failed"))
}
return nil
}
}
容易踩的坑：body 被提前消费
Buffalo 的 c.Request().Body 是一次性流，一旦被中间件或 c.Param()/c.Body() 读过就变空。签名验证必须在所有其他中间件之前注册，且不能调用任何会触发 body 解析的方法（比如 c.Body()、c.FormValue()）。否则后续 handler 收到的是空 body，导致 JSON 解析失败。
更稳妥的做法是：把签名中间件放在 app.Use() 的最顶部，并在其中完成全部 body 读取、签名计算、重置操作——这是唯一可控的方式。
真正难的不是写 HMAC，而是保证 body 在签名、日志、业务 handler 三者之间不丢不乱。这点上 Buffalo 比 Gin 更容易出错，因为它的上下文抽象隐藏了底层细节。
