echo.new()后必须调用e.use(middleware.recover())，否则panic会导致goroutine终止、http连接挂起、前端无响应且日志仅存stack trace；该中间件是echo唯一能捕获runtime panic的机制。
echo.New()之后必须调用e.Use(middleware.Recover())
不加这句，线上 panic 会直接终止 goroutine，HTTP 连接挂起，前端收不到任何响应，日志里可能只有一行 stack trace。这不是“偶尔出错”，而是上线即高危。
-
middleware.Recover()是 Echo 唯一能兜住 runtime panic 的中间件，它默认不启用 - 别依赖
e.HTTPErrorHandler——它只处理框架层错误（比如c.JSON()序列化失败），不接管 panic - 如果用了自定义
http.Server，还要确保server.ErrorLog配置到位，否则 panic 日志可能被丢弃 - 开发期可设
e.Debug = true查看详细堆栈，但生产环境必须关掉
路由分组必须按业务域，不能嵌套或按 HTTP 方法切分
常见反模式是 e.Group("/api").Group("/v1").Group("/users")，路径前缀冗余、中间件漏挂、调试时根本搞不清哪层生效。真正的扩展性来自清晰的边界划分。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 正确写法：
userGroup := e.Group("/api/v1/users")，版本号必须体现在路径中（/v1/），别用 Accept header 或 query 参数 - 每个分组只挂自己需要的中间件，比如
userGroup.Use(authMiddleware)，CORS 和日志这类通用中间件应单独注册在顶层 - 禁止嵌套分组：嵌套会导致中间件继承逻辑变复杂，v5 升级后行为有变化，老项目升级容易出鉴权失效
- 别把所有路由塞进根
e实例——20 个接口后就会出现权限错配、中间件重复执行等问题
c.Bind() 和 c.Validate() 不等于业务校验
这两个函数只做结构合法性检查，不是业务规则守门员。字段存在、长度合规、邮箱格式对，不代表“用户名未被注册”或“密码和确认密码一致”。
-
c.Bind()默认静默跳过未传字段，除非结构体字段加了json:"name,required"；但即使加了，也只校验存在性，不校验语义 -
c.Validate()依赖 struct tag（如validate:"required,email"），但不支持跨字段校验（比如 password 和 confirm_password） - 绑定失败时默认返回 400，但错误信息是原始 struct 字段名（
"Email"），建议统一包装成小写 key + 可读消息，避免暴露内部结构 - 唯一性校验、状态流转、关联约束等，必须交给 service 层，不能在 handler 里查 DB——否则 handler 耦合 repository，单元测试无法 mock
中间件传值必须用强类型 context key，别用 c.Set("key", value)
c.Set() 看似方便，实则类型不安全、易拼错、IDE 无法提示，后期维护成本极高。真正可落地的做法是封装一层类型安全的取值方法。
- 定义私有 key 类型：
type userCtxKey string；常量：const userIDKey userCtxKey = "user_id" - 在 auth 中间件里存值：
c.Set(userIDKey, uint64(123)) - 封装取值方法：
func GetUserID(c echo.Context) (uint64, bool) { v := c.Get(userIDKey); id, ok := v.(uint64); return id, ok } - 所有中间件内启 goroutine 时，必须用
c.Request().Context()并加超时控制，否则请求 cancel 后 goroutine 还在跑
c.Status() 和 c.JSON() 调用。规范不是为了好看，是让第 3 个人接手时，能 5 分钟看懂数据从哪来、错误往哪走、权限在哪断。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
