buffalo 路由必须全部在 app.routes() 中注册，不支持动态添加；路由需明确指定 http 方法，路径参数用 {id} 格式；app.resource() 生成的路由可并存但不可覆盖；中间件分全局（app.use）和路由级（显式传参），执行顺序为全局→路由级→handler；路径参数不校验类型与段数，需手动处理。
Buffalo 的路由注册必须在 app.Routes() 里完成
Buffalo 不支持像 gorilla/mux 那样在任意位置调用 r.HandleFunc()，所有路由定义必须收口到 app.Routes() 函数中——这是它类型安全路由系统的基础。如果你在 handler 外部或中间件里尝试动态加路由，会被忽略，且无任何报错提示。
常见错误是把路由写在 actions/*.go 文件顶层，或试图在 app.Use() 里注册，结果请求 404 却找不到原因。
-
app.Routes()是唯一合法入口，返回一个buffalo.App实例的路由树 - 每个路由必须绑定明确的 HTTP 方法：用
app.GET()、app.POST()等，不能混用app.Any()除非真需要 - 路径参数必须用
{id}格式（不是:id或<id></id>），否则c.Param("id")取不到值
app.Resource() 生成的 REST 路由可被部分覆盖
调用 app.Resource("/users", UsersResource{}) 会自动注册 7 个标准路由（index、show、create 等），但你仍可以在它之后用 app.GET("/users/me", MeHandler) 插入自定义路由——Buffalo 允许同路径不同 method 或带额外路径段的覆盖，但不会替换已有路由。
注意：如果写 app.GET("/users", CustomIndex)，它不会覆盖 Resource 生成的 GET /users，而是并存；实际匹配时按注册顺序，先注册的优先。这容易导致意外交互，尤其当 Resource 在前、自定义 GET 在后时，后者根本不会被触发。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 想完全替换 Resource 行为？别用
Resource()，手写全部app.GET/POST/PUT - 想保留 Resource 但加一个新端点（如
/users/export），直接追加即可，无需特殊处理 - 调试路由冲突可用
buffalo routesCLI 命令，输出当前全部注册路径和 handler 名
带中间件的路由需显式传参，不能靠全局挂载
Buffalo 的中间件是 per-route 绑定的，app.Use(mw) 是全局中间件，对所有路由生效；而 app.GET("/api/data", DataHandler, mw1, mw2) 这种写法才是给单个路由加中间件。两者不互斥，但执行顺序是：全局中间件 → 路由级中间件 → handler。
典型陷阱是以为 app.Use(auth.Middleware) 已保护了 API 路由，结果发现 /healthz 也被拦住——这时不该删 Use()，而该为健康检查路由单独指定空中间件列表：app.GET("/healthz", HealthHandler)（不传中间件参数）。
- 中间件函数签名必须是
func(next buffalo.Handler) buffalo.Handler - 若中间件依赖 context 数据（如 DB 连接），确保它在
next(c)前已注入，否则下游 handler 会 panic - 路由级中间件只影响该条路由，适合做细粒度控制（如某个 POST 接口要限流，其余不用）
路由参数解析失败时 c.Param() 返回空字符串而非 error
Buffalo 不校验路径参数格式，/users/{id} 匹配 /users/abc 也会成功，此时 c.Param("id") 返回 "abc"。如果你期望 id 是整数，必须手动转换并处理 error，框架不会提前拦截。
更隐蔽的问题是：当路径含多个参数（如 /posts/{year}/{month}/{slug}），而某次请求是 /posts/2024/09（少一层），Buffalo 默认不会 fallback 到其他路由，而是 404——它严格按段数匹配，不支持“可选参数”语法。
- 强制类型校验建议放在 handler 开头：
id, err := strconv.Atoi(c.Param("id")) - 需要可选路径段？只能拆成多条路由：
app.GET("/posts/{year}", YearHandler)和app.GET("/posts/{year}/{month}", YearMonthHandler) -
c.Params()返回 map，但 key 是字符串，没有类型信息，别依赖反射自动解构
Routes() 的封闭性。
