动态过滤器的核心不是“注册”，而是“替换”：需将过滤逻辑封装为不可变结构体，配置变更时构造全新handler实例，并用atomic.StorePointer原子切换指针，确保热更新时新旧请求规则不撕裂。
动态过滤器的核心不是“注册”，而是“替换”
Go 没有运行时类加载机制，所谓“动态装载”本质是用新规则实例原子替换旧规则实例。直接往全局 map 里增删字段、或调用某个 RegisterFilter 函数，都会引发并发不安全或中间件链断裂。真正可靠的做法是：把过滤逻辑封装成不可变结构体，每次配置变更后构造全新实例，再用 atomic.StorePointer 切换指针。
- 不要复用旧
RouterTable或FilterChain实例，避免写竞态 - 每个过滤器实现必须满足
http.Handler接口，才能被标准库链式调用 - 配置热更新时，先解析新规则（如 JSON 文件或 DB 查询），验证通过后再构建新 handler 实例
- 用
sync.RWMutex包裹读多写少场景；高吞吐建议用atomic.Value存储 handler 指针
如何让过滤器支持运行时参数（如 role=public）
硬编码 blacklist["public"] 在函数里会锁死逻辑，无法适配不同请求上下文。正确做法是把参数提取和规则匹配解耦：过滤器只接收一个 func(*http.Request) string 类型的 role 提取器，而不是字符串常量。
- 定义类型：
type RoleExtractor func(*http.Request) string - 在中间件初始化时注入该函数，比如从
X-User-Roleheader 或 JWT claim 中取值 - 黑名单数据结构用
map[string][]string，但 key 不写死，由 extractor 动态提供 - 注意 extractor 返回空字符串时的 fallback 处理，避免 panic 或误匹配默认规则
为什么用反射做字段过滤容易出错
很多人想用反射自动跳过 PasswordHash 字段，结果发现 json:"-" 标签根本不起作用——因为 reflect.StructField.Tag 只存原始字符串，reflect 包不会解析它。你得手动调用 field.Tag.Get("json")，再判断是否等于 "-" 或含 omitempty。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 未导出字段（小写字母开头）永远拿不到，别试图“过滤”它们——根本看不见
- 嵌套结构体字段不会继承外层 tag，每一层都得单独检查
field.Tag.Get("json") -
reflect.Value.Interface()对 nil 指针调用会 panic，必须先IsValid()和CanInterface() - 更稳的方案是放弃反射，改用专用响应 struct + 显式赋值，编译期就能兜住字段漏写
HTTP 中间件链里怎么避免重复执行或死循环
常见错误是在中间件里多次调用 next.ServeHTTP()，比如加了日志又加鉴权，结果两个中间件都各自调了一次 next，导致 handler 执行两次。关键在于：每个中间件只负责自己那层逻辑，且只调用一次 next。
立即学习“go语言免费学习笔记（深入）”；
- 中间件返回的是新
http.Handler，不是修改原 handler；链式包装靠闭包捕获 next - 鉴权失败要
return，不能继续调next.ServeHTTP，否则后续逻辑仍会执行 - 日志中间件应放在最外层，确保所有请求都被统计，包括被拦截的
- 调试时打印
r.URL.Path和r.Method，确认是否同一请求被多个中间件重复处理
