必须调用 e.start() 或 e.startserver() 启动服务，否则监听无响应；路径参数需严格匹配大小写和斜杠；结构体字段须大写并加 json tag 才能序列化；需启用 middleware.recover() 捕获 panic。
漏掉 e.Start() 或用错 HTTP 启动方式，服务就卡在监听但无响应——这是新手最常踩的坑。
echo.New() 之后必须显式调用 Start() 或 StartServer()
echo.New() 只返回一个未初始化的实例，不绑定端口、不启动监听。它不是“创建完就能跑”的对象。
- 最简启动：直接
e.Start(":8080")，内部会新建http.Server并调用ListenAndServe - 若需自定义超时、TLS、ReadHeaderTimeout 等，必须手动构造
*http.Server，再传给e.StartServer(server) - 绝对不要写
http.ListenAndServe(":8080", e)—— 这绕过了 Echo 的路由匹配和中间件链，GET路由全失效，curl会 pending，netstat却显示端口已监听
c.Param("id") 总是空？检查路径匹配是否严格
Echo 的路径参数提取依赖**完全精确的路径匹配**，大小写、尾部斜杠、正则约束缺一不可。
- 注册了
e.GET("/user/:id", handler)，但请求是/user/123/（末尾斜杠）→ 不匹配，c.Param("id")返回空字符串 - 注册了
/User/:ID（大写），但请求是/user/123（小写）→ 默认区分大小写，不匹配 - 想限制
:id只接受数字？得加正则：/user/:id([0-9]+)，否则:id会吞掉后续所有路径段
c.JSON() 返回空对象？结构体字段没加 json tag
Go 结构体字段首字母小写默认不可导出，Echo 序列化时直接跳过，结果就是 {}。
- 错误写法：
type User { name string }→ 字段name小写且无 tag → JSON 中消失 - 正确写法：
type User { Name string `json:"name"` }→ 首字母大写 + 显式json:"name" -
c.JSON(200, data)已自动设置Content-Type: application/json; charset=UTF-8，无需手动c.Header() - 含
time.Time字段时，默认序列化为 RFC3339 字符串，前端new Date()可能解析失败；建议提前转成Unix()或格式化字符串
panic 导致接口静默崩溃？必须配 Recover 中间件
Echo 默认不 recover panic，一旦 handler 或中间件 panic，整个 HTTP 连接直接断开，日志里可能只有一行 goroutine crash，没有 500 响应。
- 必须显式启用：
e.Use(middleware.Recover()) - 别依赖
e.HTTPErrorHandler捕获 panic——它只处理 Echo 自身抛出的错误，不接管 runtime panic - 如果用了自定义
http.Server，还要确保server.ErrorLog配置到位，否则 panic 日志可能被丢弃
最隐蔽的问题往往藏在“看起来跑起来了”的地方：端口监听了、路由注册了、handler 也写了——但少调一次 e.Start()，或少加一个 json:"xxx" tag，就足以让整个接口在生产环境里静默失联。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
