Echo服务默认监听127.0.0.1导致公网不可访问，且不自动识别X-Forwarded-*头，需启用ForwardedByClientIP、设置TrustedProxies并手动修正Request.URL.Scheme为https。
为什么 echo.New() 启动的服务不能直接暴露给公网
因为默认监听 127.0.0.1:8080（或类似地址），Nginx 反向代理时若后端配置为 http://127.0.0.1:8080，在非本机访问时会失败；更关键的是，Echo 默认不自动识别 X-Forwarded-For 和 X-Forwarded-Proto，导致 c.RealIP() 返回空、c.Request().URL.Scheme 始终是 http，即使 Nginx 已配 HTTPS。
解决办法不是改 Nginx，而是让 Echo 主动信任代理 IP 并解析头信息：
- 调用
e.ForwardedByClientIP = true启用客户端 IP 解析 - 设置
e.IPExtractor = echo.ExtractIPFromXFFHeader（或自定义提取逻辑） - 必须显式指定可信代理网段，例如：
e.TrustedProxies = []string{"127.0.0.1", "::1", "192.168.0.0/16"}—— 如果 Nginx 在同一台机器，至少要包含127.0.0.1
Nginx 配置里 proxy_pass 的末尾斜杠怎么影响路径
这直接决定请求路径是否被“重写”。假设 Echo 路由注册了 GET /api/users，而 Nginx 配置如下：
location /api/ {
proxy_pass http://127.0.0.1:8080/;
}
此时浏览器访问 /api/users，Nginx 会把 /api/ 前缀去掉，转发 /users 到 Echo —— 这是正确行为。但如果写成：
立即学习“go语言免费学习笔记（深入）”；
location /api/ {
proxy_pass http://127.0.0.1:8080;
}
则会原样转发 /api/users，Echo 找不到该路由（除非你注册了 /api/users）。所以规则很简单：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 如果
proxy_pass值以/结尾，Nginx 自动 strip 匹配的 location 前缀 - 如果没结尾斜杠，Nginx 不做路径替换，原样转发
- 推荐统一用带尾部
/的写法，并确保 Echo 路由不带前缀（如只写/users）
如何让 Echo 正确生成 HTTPS 链接（比如重定向、JWT issuer）
仅靠 Nginx 转发 HTTPS 请求还不够。Echo 默认从 c.Request().TLS 判断是否为 HTTPS，但反向代理后该字段为 nil。必须结合两个动作：
- Nginx 中添加头：
proxy_set_header X-Forwarded-Proto $scheme; - Echo 中启用协议感知：
e.Use(middleware.HTTPSRedirect())本身不生效，需配合middleware.SecureWithConfig或手动检查头
更稳妥的做法是在中间件中统一修正 URL Scheme：
e.Use(func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
if c.Request().Header.Get("X-Forwarded-Proto") == "https" {
c.Request().URL.Scheme = "https"
}
return next(c)
}
})
这样后续所有 c.Request().URL.String() 或 c.Echo().Reverse() 都能拿到正确协议。
静态文件 404 或 MIME 类型错误的常见原因
当 Echo 用 e.Static("/static", "./public") 提供静态资源，Nginx 却返回 404 或把 .js 当作 text/plain，问题往往不在 Echo，而在 Nginx 是否接管了这些路径：
- 如果 Nginx 的
location /static/没配alias或root，请求会落到proxy_pass，Echo 尝试处理但找不到对应路由（因Static()是按前缀匹配，且不处理子目录嵌套） - 正确做法是：Nginx 直接服务静态文件，不走代理。例如：
location /static/ { alias /path/to/your/public/; expires 1y; } - 若坚持让 Echo 处理，必须确保 Nginx 的
location不截断路径，且 Echo 的Static()第一个参数与 location 完全一致（包括末尾斜杠）
另外注意：Nginx 默认不识别 .webp 等新格式，需在 mime.types 中补充，否则返回 application/octet-stream。
