必须显式调用 e.Start() 或 e.StartServer() 启动服务，否则仅监听端口却无响应；路径匹配严格区分大小写和斜杠；结构体字段须大写并加 json tag 才能序列化；必须启用 middleware.Recover() 捕获 panic。
不调用 e.Start() 或 e.StartServer()，服务就只是个空壳，监听端口但永不响应请求——这是最常被忽略的启动前提。
为什么 e.GET() 写完了却收不到请求？
Echo 实例不是“注册完路由就自动跑起来”的对象。echo.New() 只返回一个未初始化的结构体，它不绑定端口、不启用中间件、不接管 HTTP 生命周期。
- 必须显式调用
e.Start(":8080")才会新建*http.Server并调用ListenAndServe - 若需设置
ReadTimeout、WriteTimeout或 TLS，必须手动构造*http.Server，再传给e.StartServer(server) - 绝对不要写
http.ListenAndServe(":8080", e)——这绕过了 Echo 的路由树和中间件链，所有GET/POST都会 404 或 pending - 常见现象：
netstat -an | grep 8080显示端口已监听，但curl http://localhost:8080一直挂起、无日志、无响应
c.Param("id") 总是空？路径匹配比你想象得更严格
Echo 的基数树路由匹配是精确的：大小写、尾部斜杠、正则约束缺一不可。它不会“尽力提取”，不匹配就直接跳过参数解析。
- 注册的是
/user/:id，但请求 URL 是/user/123/（末尾斜杠）→ 不匹配 →c.Param("id") == "" - 注册的是
/User/:ID（大写 U/D），请求是/user/123（小写）→ 默认区分大小写，不匹配 - 想限制
:id只接受数字？必须写成/user/:id([0-9]+)；否则:id会吞掉整个后续路径段（如/user/123/extra中id = "123/extra"） - 调试建议：在 handler 开头加
c.Logger().Info(c.Request().URL.Path)，确认实际进来的路径和你注册的是否一致
c.Bind() 静默失败，c.JSON() 返回空对象？检查字段导出性与 tag
c.Bind() 对 JSON 解析异常极其安静：字段名不匹配、类型错误、缺少 Content-Type: application/json 头，它都只让字段保持零值，不报错也不中断。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 结构体字段必须首字母大写（可导出），且带
json:"xxx"tag，否则序列化/反序列化时直接跳过 - 错误写法：
type User { name string }→ 字段name小写无 tag →c.Bind()不赋值，c.JSON()输出{} - 正确写法：
type User { Name string `json:"name"` } -
c.JSON(200, data)已自动设Content-Type: application/json; charset=UTF-8，无需手动c.Header() - 含
time.Time字段时，默认序列化为 RFC3339（如"2026-05-22T13:48:00+08:00"），前端new Date()在部分环境可能解析失败；建议提前转Unix()或格式化为字符串
panic 导致接口静默崩溃？middleware.Recover() 不是可选项
Echo 默认不 recover 任何 panic——这不是疏忽，是设计选择。一旦 handler 或中间件 panic，goroutine 直接退出，HTTP 连接挂起，无响应、无日志、无错误提示。
- 必须显式启用：
e.Use(middleware.Recover())，且应放在所有可能 panic 的中间件之前 -
e.HTTPErrorHandler不处理 panic，它只捕获echo.HTTPError等框架抛出的错误 - 若用了自定义
*http.Server，还要确保server.ErrorLog配置到位，否则 recover 日志可能被丢弃 - 替换 Gin 时尤其危险：Gin 默认 recover 全局 panic 并返回 500；Echo 不做这件事，线上接口突然失联，八成是这里漏了
真正难调试的问题，往往藏在“看起来跑起来了”的地方：端口监听了、路由注册了、handler 也写了——但少一次 e.Start()，或少一个 json:"name" tag，就足以让整个接口在生产环境里静默失联。
