echo.new()后必须调用e.start()或e.startserver()才能启动服务，否则端口虽显示监听但请求挂起无响应；它仅初始化空壳，不绑定路由、中间件或http.server。
echo.New() 后不调用 Start() 就运行，服务会假死
这是 GoLand 里最常被忽略的启动逻辑错误：代码能编译、进程在跑、netstat -an | grep 8080 显示端口已监听，但 curl http://localhost:8080 一直挂起，控制台零日志、无 panic、无响应——根本不是“没连上”，而是 Echo 实例压根没进入请求处理循环。
原因很简单：echo.New() 只初始化一个空壳，不含路由匹配器、无中间件链、不绑定 http.Server。它甚至不注册任何默认 handler。
- 正确写法是
e.Start(":8080")，内部新建http.Server并接管整个生命周期 - 若需自定义超时（如
ReadTimeout），必须手动构造*http.Server，再传给e.StartServer(server) - 绝对不要写
http.ListenAndServe(":8080", e)：这绕过 Echo 的中间件和路由，所有GET都 404 或 pending - GoLand 调试时建议在
e.Start()前加断点，确认变量e已注册路由且非空
路由参数 c.Param("id") 总是空？检查路径是否严格匹配
在 GoLand 里设断点进 handler，发现 c.Param("id") 返回空字符串，不是代码写错，大概率是路径注册和请求 URL 不完全一致。Echo 的路径匹配是精确到大小写、斜杠、正则约束的。
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 注册了
e.GET("/user/:id", h)，但请求是/user/123/（尾部斜杠）→ 不匹配 - 注册了
/User/:ID（大写），但请求是/user/123（小写）→ 默认区分大小写 - 想让
:id只接受数字？必须加正则约束：/user/:id([0-9]+)，否则:id会吞掉后续所有路径段（比如/user/123/posts中的posts） - 调试时可打印
c.Request().URL.Path和注册的路由 pattern 对比，避免肉眼误判
GoLand 调试时看不到中间件日志？记得启用 Logger 和 Recover
刚建完 Echo 实例就跑起来，结果 panic 导致进程退出、日志全无，或中间件（如日志、认证）完全没生效——因为默认情况下 Echo 不自动加载任何中间件。
- 必须显式添加：
e.Use(middleware.Logger())和e.Use(middleware.Recover()) -
middleware.Recover()很关键：没有它，handler 里任何 panic 都会让整个 server 崩溃，GoLand 调试器直接断连，看不到堆栈 - Logger 默认输出到 stdout，GoLand 的 Run 窗口能直接看到每条请求的 method、path、status、latency
- 如果用了自定义
echo.HTTPErrorHandler，确保它没吞掉 error 日志（比如忘了e.Logger.Error(err)）
静态文件 404？e.Static() 的路径参数顺序不能反
在 GoLand 里配置好 e.Static("/static", "public")，浏览器访问 /static/main.js 却返回 404，不是文件不存在，而是两个路径参数意义被搞反了。
- 第一个参数
"/static"是**对外暴露的 URL 前缀**（浏览器访问路径） - 第二个参数
"public"是**本地磁盘上的真实目录路径**（相对当前工作目录） - 常见错误：写成
e.Static("public", "/static")→ 完全无效，无报错但不生效 - 调试建议：在 GoLand 中右键项目根目录 → “Show in Explorer”，确认
public文件夹确实在该路径下；也可临时加一行fmt.Println(os.Getwd())确认工作目录
e.Start() 之前完成注册——一旦 Start() 执行，Echo 就进入阻塞监听状态，后续调用 e.GET() 或 e.Use() 全部静默失效。
