Go反射遍历结构体字段生成API文档时，json标签未生效是因为非导出字段（小写开头）无法被reflect访问，且需用reflect.StructTag解析；http.ServeMux路径匹配为前缀匹配，需按从具体到宽泛顺序注册；反射调用handler前须校验IsValid和CanCall，避免zero Value panic。
反射遍历结构体字段生成API文档时，json标签没生效？
Go 的 reflect 包读不到 json 标签，是因为默认只暴露导出（大写开头）字段，且标签必须用 reflect.StructTag 显式解析。非导出字段哪怕加了 json:"xxx"，reflect.Value.Field(i).Tag.Get("json") 也会返回空字符串。
- 确保结构体字段首字母大写（如
Name而非name），否则反射根本拿不到该字段 - 用
reflect.TypeOf(t).Field(i).Tag.Get("json")读取标签，不是reflect.Value上的方法 - 若字段类型是嵌套结构体，需递归处理；但别自动展开所有嵌套——实际 API 文档里通常只展示一级字段或按需标记
swaggerignore:"true" - 注意
json:",omitempty"这类带逗号的值，Tag.Get("json")返回的是完整字符串，需自己解析键值对
用 http.ServeMux 做动态路由时，路径冲突导致 404？
http.ServeMux 是前缀匹配，不是全路径匹配。注册 /api/users 后再注册 /api，后者会吞掉前者——因为 /api/users 也以 /api 开头。
- 注册顺序很重要：先注册更具体的路径，再注册更宽泛的，比如先
/api/users/:id（如果用了占位符），再/api/ -
http.ServeMux本身不支持路径参数（如:id或*path），遇到就得自己 parser.URL.Path，容易出错 - 如果真要动态注册，建议改用
gorilla/mux或chi，它们原生支持{id}占位符和Router.Walk()遍历已注册路由 - 用
http.HandleFunc手动分发时，记得检查r.Method，别让 POST 请求落到 GET 处理函数里
反射提取 handler 函数签名生成 OpenAPI spec，reflect.Func 参数类型怎么对应 HTTP 方法？
Go 函数没有元信息绑定 HTTP 方法，reflect.TypeOf(fn).In(0) 只知道第一个参数是 *http.Request，但不知道它该响应 GET 还是 PATCH。靠函数名约定（如 GetUser、PatchUser）最常见，但也最脆弱。
- 别依赖函数名大小写或后缀自动推断——
HandleUserUpdate和UpdateUserHandler意图相同，但规则难统一 - 更稳妥的方式是在函数上加注释标记，比如
// @method POST /api/users，然后用runtime.FuncForPC(reflect.ValueOf(fn).Pointer()).Name()反查源码行，配合 AST 解析注释（需要go/parser） - 如果 handler 是闭包或方法值（
u.GetUser），reflect.Value的Call可用，但FuncForPC可能返回unknown，此时只能靠外部配置补全 method/path - 参数里含
context.Context很常见，但它不属于 OpenAPI 参数列表，提取时得跳过
自动生成的路由在生产环境 panic，错误信息是 panic: reflect: Call using zero Value
这是典型反射调用空指针或未初始化值的报错。常见于：把结构体字段当作方法调用、对 nil 接口变量做 reflect.Value.Call、或 handler 函数本身是 nil。
立即学习“go语言免费学习笔记（深入）”；
- 注册前先用
if !reflect.ValueOf(handler).IsValid() || !reflect.ValueOf(handler).CanCall()检查，避免后续 panic - 如果 handler 来自 map 查找（如
handlers["user.get"]），查不到时返回的是 nil func，直接reflect.ValueOf(nil)就是 zero Value - 使用
reflect.MakeFunc动态构造 handler 时，返回值类型必须严格匹配func(http.ResponseWriter, *http.Request)，少一个参数或类型错位都会在 Call 时报这个错 - 日志里打
reflect.TypeOf(handler).String()比打handler本身更有助定位——能看出是func()还是func(int) string
反射+Web 路由的组合，最难的不是“怎么列出所有 handler”，而是“怎么保证每个 handler 在被反射调用前，它的依赖（DB 实例、配置、中间件）已经就位”。这块没法靠反射自动解决，得靠显式初始化顺序或依赖注入容器兜底。
