租户标识须从host头、x-tenant-id header或url路径安全提取，优先host或header，禁用c.param("tenant")；提取后经格式校验（如正则/uuid），非法值返回400/403；再通过c.set(tenantcontextkey, tenantid)注入echo context，键需全局唯一常量定义。
中间件里怎么提取租户标识
租户隔离的前提是能稳定、可靠地从请求中识别出当前租户。Echo 没有内置租户概念，得自己从 Host、Header（如 X-Tenant-ID）、或 URL path（如 /t/{tenant}/api/...）里取值。推荐优先用 Host 或 X-Tenant-ID，路径解析容易和路由冲突，且对前端不透明。
常见错误是直接用 c.Param("tenant")，但该函数只对路由中显式声明的参数有效（比如 /t/:tenant/users），而多数场景租户信息不在路由里。正确做法是：
- 若租户在 Host 中（如
tenant1.example.com），用c.Request().Host或c.Request().URL.Host提取，再查映射表 - 若在 Header 中，用
c.Request().Header.Get("X-Tenant-ID")，注意空格和大小写（HTTP Header 名不区分大小写，但 Go 的Get方法对键名大小写不敏感） - 务必校验非空和格式（如 UUID 或正则匹配），非法值应直接返回
400或403，不要往下传
如何把租户上下文注入 Echo Context
Echo 的 echo.Context 支持自定义键值对，用 c.Set(key, value) 存，c.Get(key) 取。关键点在于：键必须全局唯一，避免和其他中间件冲突。别用字符串字面量如 "tenant"，推荐定义常量：
const TenantContextKey = "tenant_id"
func TenantMiddleware() echo.MiddlewareFunc {
return func(next echo.Handler) echo.Handler {
return echo.HandlerFunc(func(c echo.Context) error {
tenantID := extractTenantID(c) // 上一步实现的提取逻辑
if tenantID == "" {
return echo.NewHTTPError(http.StatusForbidden, "missing tenant")
}
c.Set(TenantContextKey, tenantID)
return next(c)
})
}
}
后续 handler 里统一用 c.Get(TenantContextKey) 获取，类型断言时加检查：
if tenantID, ok := c.Get(TenantContextKey).(string); !ok {
return echo.NewHTTPError(http.StatusInternalServerError, "invalid tenant context")
}
数据库连接怎么按租户切换
租户隔离最常踩的坑是“连接复用污染”——一个 goroutine 用完连接后没重置 schema 或没切库，下一个请求（不同租户）误用了前一个租户的数据。Echo 中间件本身不管理 DB 连接，你得在业务 handler 里做两件事：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 从
c.Get(TenantContextKey)拿到租户 ID 后，查租户配置（比如租户专属 DB URL 或 schema 名） - 每次请求都新建或获取对应租户的 DB 实例（推荐用连接池 + 租户键缓存，如
map[string]*sql.DB），别复用全局*sql.DB - 如果共用单库多 schema（PostgreSQL/MySQL），务必在执行 SQL 前设
SET search_path TO tenant_123或拼接tenant_123.users表名，不能依赖连接初始化时的默认 schema
注意：GORM 等 ORM 默认不支持运行时切换 schema，需手动拼接或用 Session(&gorm.Session{Context: ...}) 控制作用域。
中间件顺序为什么影响租户隔离效果
租户中间件必须在所有依赖租户上下文的中间件之前注册，否则后续中间件读不到 c.Get(TenantContextKey)。典型错误顺序：
e.Use(loggingMiddleware) // ❌ 日志中间件想打租户 ID，但此时还没 set
e.Use(TenantMiddleware()) // ✅ 必须放前面
e.Use(authMiddleware) // ✅ 认证要基于租户查用户表
e.GET("/users", handler)
更隐蔽的问题是：如果你用了 e.Group("/api") 并在 group 上挂中间件，要确认租户中间件是否也挂到了该 group —— Echo 不会自动继承 root 的中间件到子 group，必须显式调用 group.Use(TenantMiddleware())。
租户标识一旦提取并写入 context，就该视为只读。任何试图在下游中间件里覆盖 c.Set(TenantContextKey, ...) 的行为，都会破坏隔离边界，这点容易被忽略。
