应使用 r.Header.Get("User-Agent") 安全读取，避免直接访问 r.Header["User-Agent"]；设备识别推荐 udger-go 或 grouse，需初始化复用解析器；本地调试时浏览器默认发送桌面 UA，须用 curl 或 Postman 模拟真实移动 UA。
怎么从 *http.Request 里安全读取 User-Agent
Go 的 HTTP 处理中，User-Agent 是请求头字段，不是结构体字段，不能直接写 r.UserAgent —— 这会编译报错。必须通过 r.Header.Get("User-Agent") 获取，且注意大小写不敏感，但 Go 的 Header.Get 内部已处理好。
常见错误是直接访问 r.Header["User-Agent"]，这可能返回空 slice 或 panic（如果 Header 被冻结）；更糟的是忽略空值导致后续 panic。
- 始终用
r.Header.Get("User-Agent")，别手写 key 大小写变体（如"user-agent"或"USER-AGENT"） - 返回值是
string，但可能为空字符串（比如 curl -H "User-Agent:"），需显式检查ua == "" - 不要在中间件里修改
r.Header后再读 —— 某些代理或测试框架会冻结 Header，此时Get仍可用，但赋值会 panic
用什么库做设备类型识别比较靠谱
纯靠字符串匹配 User-Agent 做设备判断极不可靠：现代浏览器 UA 字符串冗长、伪造普遍、移动端常带桌面标识（如 Chrome on Android 带 "X11; Linux x86_64"）。硬写正则容易漏判或误判。
推荐用 udger-go 或 grouse，二者都基于 Udger 的设备数据库（定期更新），支持解析出设备类型、OS、浏览器、是否爬虫等字段。不建议用已归档的 mobile-detector 或维护停滞的 go-useragent。
立即学习“go语言免费学习笔记（深入）”；
-
udger-go需要下载udgerdb.dat文件（免费注册获取），初始化一次后并发安全，适合长期运行服务 -
grouse纯内存解析，无外部依赖，但只支持基础分类（mobile/desktop/bot），不区分平板/折叠屏等细节 - 避免在每次请求里 new 解析器 —— 初始化一次复用，否则 GC 压力明显
Parse() 返回的设备类型字段怎么用才不翻车
以 udger-go 为例，parser.Parse(r.Header.Get("User-Agent")) 返回结构体，关键字段是 .DeviceClass 和 .OsName。但要注意：DeviceClass 只有三个值："desktop"、"mobile"、"tablet"，没有 "bot" 或 "tv" —— 后者得看 .IsCrawler 和 .DeviceName 组合判断。
- 别把
.DeviceClass == "mobile"当作“一定是手机”——某些折叠屏浏览器返回"desktop"，而部分微信内置浏览器返回"tablet" -
.OsName可能为空（如匿名代理），别直接strings.Contains(ua, "iOS")回退，应优先信解析结果，空时再 fallback - 如果业务只关心“是否触屏”，建议同时看
.IsTouchCapable字段，比单纯看设备类型更准
为什么本地开发时总识别成 desktop
因为你在 Chrome / Safari 里调试，默认 UA 是桌面版。即使开了开发者工具的“设备模拟”，实际发到后端的仍是原始桌面 UA —— 模拟只影响页面渲染和 JS 的 navigator.userAgent，不影响真实 HTTP 请求头。
- 用 curl 测试：
curl -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1" http://localhost:8080 - Postman 或 VS Code REST Client 可手动设 Header，记得关掉 “Automatically add default headers”
- Chrome DevTools 的 Network → 右键请求 → “Copy as cURL” 能看到真实发出的 UA，别信 Preview 里的渲染结果
设备识别的边界情况很多，比如微信安卓版 UA 里带 MicroMessenger 却标为 desktop，这时候得结合 .UaFamily 和业务上下文二次判断 —— 没有银弹，只有分层兜底。
