uap-go 初始化必须显式加载规则，否则解析结果全为空；需全局复用 *uap.parser 实例并限制缓存大小；device.model 和 os.version 为空属正常，应优先依赖 device.family 和 os.family；ua 不可信，不可用于安全决策。
uap-go 初始化必须加载规则，否则解析全为空
直接 new 一个 uap.Parser 不会自动加载识别规则，Parse() 返回的 useragent.UserAgent 结构体里所有字段都是空字符串，但不会 panic —— 这是最隐蔽的坑。常见错误是只 import 包、调用 uap.NewParser() 就开始解析，结果日志里全是 "Other" 和空 Device.Family。
正确做法是显式传入规则数据：
- 从
ua-parser/uap-core仓库下载最新regexes.yaml，用uap.New(uap.WithYamlFile("regexes.yaml")) - 或读成字节切片后用
uap.New(uap.WithYamlBytes(yamlBytes)) - 别用网上过时的 yaml 片段 —— iOS 18、鸿蒙 NEXT、微信 8.0.52 内置 WebView 的识别逻辑都依赖 2025 年后更新的规则
高并发下 CPU 飙升？别每次请求都 new Parser
uap.Parser.Parse() 本身是无状态的，但内部正则编译和缓存管理有开销。如果在 HTTP handler 里每次请求都 uap.New(...)，QPS 上千时 CPU 会卡在 regexp.(*Regexp).doExecute。
必须做三件事：
- 全局复用单个
*uap.Parser实例（它 goroutine-safe） - 初始化时限制 LRU 缓存大小：
uap.New(uap.WithCacheSize(1000))，防容器内存溢出 - 若只关心设备类型（如是否为移动），改用
parser.ParseShort(uaStr)，快 3–4 倍，且不触发完整正则匹配
Device.Model 和 OS.Version 经常为空，这不是 bug
原始 UA 字符串本身就不含这些信息。比如 Go-http-client/1.1、okhttp/4.12、内网爬虫 UA 或某些 IoT 设备上报的字符串，压根没有型号或系统版本字段。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
别强依赖这些字段，优先看更稳定的语义化字段：
-
Device.Family（如"iPhone"、"Android"、"Desktop"）和OS.Family（如"iOS"、"Windows"）基本可靠 - 遇到空值，可 fallback 粗略判断：
strings.Contains(uaStr, "Mobile") && !strings.Contains(uaStr, "Tablet")→ 手机；strings.Contains(uaStr, "Windows NT 10.0")→ Win10+ - iPadOS 13+ 会伪装成
Macintosh; Intel Mac OS X，但ua.Tablet()仍能识别，别只信字符串关键词
UA 字符串不可信，别用于安全决策
HTTP 请求头里的 User-Agent 是客户端完全可控的字符串：curl 可伪造、前端 JS 可篡改、CDN/WAF 可覆盖、WKWebView 可省略版本号。线上真实场景中，req.Header.Get("User-Agent") 返回空或被截断（Cloudflare 默认限 256 字节）非常普遍。
生产环境必须加兜底：
- 先校验非空：
uaStr := req.Header.Get("User-Agent"); if uaStr == "" { /* 记录告警并 fallback */ } - 检查长度，对超长 UA 打点监控：
if len(uaStr) > 256 { log.Warn("UA truncated", "len", len(uaStr)) } - 强依赖设备类型时，优先读
X-Device-Type（前端 SDK 主动上报）或Sec-CH-UA-Mobile（Chrome Client Hints）
设备识别可以辅助体验优化，但永远不能作为权限控制、风控拦截或支付验证的依据。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
