必须用go install github.com/gobuffalo/cli/cmd/buffalo@v1.1.4覆盖安装，确保Go≥1.21、GOPATH/bin在PATH中、shell哈希刷新；CLI升级后须同步更新项目go.mod中github.com/gobuffalo/buffalo版本并适配app.New()签名及中间件行为。
Buffalo CLI 升级到 v1.1.4 不能靠 buffalo update，必须用 go install 覆盖安装；但 CLI 升级 ≠ 项目框架升级，老项目仍锁在旧版 github.com/gobuffalo/buffalo，不改 go.mod 就会出 runtime 不兼容问题。
怎么安全升级 Buffalo CLI 到 v1.1.4
CLI 是独立二进制，和项目无关，直接覆盖安装即可，但环境缺一不可：
-
go version必须 ≥ 1.21（推荐 1.26.0），低于则报cannot find module providing package -
go env GOPATH输出非空路径（如/home/user/go），且$(go env GOPATH)/bin必须在$PATH中 - 执行
go install github.com/gobuffalo/cli/cmd/buffalo@v1.1.4（别用@latest，避免跳过目标版本） - 运行
hash -d buffalo（Linux/macOS）或重启终端，否则仍调用旧二进制 - 验证：运行
which buffalo，输出应为$(go env GOPATH)/bin/buffalo；再跑buffalo version确认是v1.1.4
为什么 buffalo dev 启动失败且报 unknown flag 或 no such file
这不是 CLI 问题，是项目里 go.mod 锁的 Buffalo runtime 版本太旧，和 v1.1.4 CLI 不匹配：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 错误
unknown flag: --log-format表明 CLI 传了新 flag，但老 runtime（如 v0.18.x）根本不认识 - 错误
no such file or directory: actions/app.go多因 v1.x 后移除了app.New()的默认参数签名，老生成代码没适配 - 打开
go.mod，找这行：github.com/gobuffalo/buffalo v0.18.13→ 改成v1.1.4 - 执行
go mod tidy，再检查actions/app.go里app.New()调用是否带buffalo.Options{...}参数（v1.x 强制要求） - 若用 Pop ORM，同步确认
github.com/gobuffalo/pop/v6版本是否 ≥ v6.17.0（v1.1.4 默认依赖）
API 版本路由在 v1.1.4 下怎么保持向后兼容
v1.1.4 没新增版本路由语法，老办法依然有效，但需注意中间件执行顺序变化：
- 所有 API 路径必须硬编码版本前缀，如
/api/v1/users，禁止用app.Group("/api/v1", ...)—— Group 在 v1.x 中仍是静态封装，无法支持灰度或运行时分发 - 校验中间件必须注册在最前：
app.Use(versionCheckMiddleware)，放在app.Use(middleware.PopTransaction(app))之前，否则事务中间件可能提前写 header 导致 404 不生效 - v1.1.4 默认启用了更严格的 CORS 处理，若旧版中间件手动设了
Access-Control-Allow-Origin，要确保没和新内置逻辑冲突（可临时注释掉自定义 CORS 中间件测试） - 新增 v2 接口时，用独立常量定义路径：
const UsersV2Path = "/api/v2/users"，保留UsersV1Path不删不改
最容易被忽略的兼容性断裂点
v1.1.4 对 Context 生命周期和中间件返回值做了静默收紧，不报错但行为已变：
- 中间件返回
nil后，v1.1.4 会严格检查后续 handler 是否存在；若路由匹配但 handler 为nil（比如函数名拼错），现在直接 500，旧版可能 404 -
c.Redirect在 v1.1.4 中默认加了http.StatusFound，若旧代码依赖 302 重定向但前端做了状态强校验，需显式传参：c.Redirect(302, "/login") - WebSocket 场景下，
gorilla/websocket.Upgrader的CheckOrigin若仍用return true，v1.1.4 日志会警告并可能被反向代理拦截（Cloudflare 已默认拒绝无 Origin 校验的 Upgrade） - 表单绑定时，
c.Bind(&s)现在对嵌套结构体字段零值更敏感，若s.Child.Name是空字符串但数据库字段不允许 NULL，Pop 插入会 panic，得提前补默认值或改 struct tag
