漏掉 e.Start() 或未配中间件会导致服务监听但无响应；c.JSON() 空对象因字段未加 json tag；/user/:id 匹配失败常因大小写、尾斜杠或缺正则约束；panic 默认不恢复，需显式启用 middleware.Recover()。
漏掉 e.Start() 或没配中间件，服务就卡在监听但无响应——这是新手最常踩的坑。
echo.New() 启动服务必须显式调用 Start()
创建 echo.New() 实例只是初始化一个空壳：没路由匹配器、没错误处理、没中间件。它不会自动监听端口。
- 正确写法是
e.Start(":8080")，这会启动内置http.Server并接管整个请求生命周期 - 如果要用自定义
http.Server（比如设ReadTimeout），必须用e.StartServer(server)；直接调server.ListenAndServe()会绕过 Echo 路由逻辑，导致 404 或 pending - 常见现象：
netstat -an | grep 8080显示端口已监听，但curl http://localhost:8080一直挂起、无日志、无响应——八成是忘了Start()
c.JSON() 返回空对象或中文乱码？检查结构体 tag 和编码
c.JSON(200, data) 内部已设 Content-Type: application/json; charset=UTF-8，但序列化行为完全依赖结构体字段 tag。
- 字段名首字母小写（如
name string）且没加json:"name"→ 序列化后该字段消失，返回看起来像{} - 含
time.Time字段时，默认转 RFC3339 字符串（如"2026-04-05T23:44:00+08:00"），前端new Date()可能不兼容；建议提前转Unix()或自定义格式 - 中文乱码极少因编码引起（
c.JSON已设 UTF-8），更可能是前端 JS 没正确解析响应，或代理/网关删了charset部分，可临时改用c.String(200, string(jsonBytes))排查
/user/:id 中 c.Param("id") 总是空？路径匹配有严格前提
Echo 的路径参数提取不是“模糊匹配”，而是基于基数树的精确路径比对，大小写、尾部斜杠、正则约束都影响结果。
立即学习“go语言免费学习笔记（深入）”；
- 注册的是
/user/:id，但请求是/user/123/（末尾斜杠）→ 不匹配，c.Param("id")返回空字符串 - 注册
/User/:ID（大写 U/D），请求用小写/user/123→ 不匹配；Echo 默认区分大小写，不自动重定向 - 想限制
:id只接受数字？必须写正则：/user/:id([0-9]+)；否则:id会吞掉后续所有路径段（如/user/123/extra中id="123/extra"）
panic 导致服务静默崩溃？默认不 recover
和 Gin 不同，Echo 不内置 panic 捕获。一旦中间件或 handler panic，进程直接退出，无日志、无错误响应——线上接口看似“突然不可用”，实则是崩了。
- 必须显式启用
middleware.Recover()：e.Use(middleware.Recover()) - 若自定义
e.HTTPErrorHandler，要确保它不 panic（比如日志写入失败再 panic 就白搭） - 注意中间件执行顺序：
Recover()必须在可能 panic 的中间件之前注册，否则无效
最简服务能跑起来，不代表路由、绑定、错误处理都可靠；Echo 的“轻量”意味着很多事得手动补全，而不是框架替你兜底。
