90%的动态业务逻辑场景用govaluate足够；它适合条件判断为主的风控、优惠券等规则，但不支持复杂流程编排，需手动注入函数、预检变量、缓存表达式实例，并注意nil处理、时间函数实时性、YAML字段映射一致性及配置治理。
规则引擎选 govaluate 还是自研表达式解析器？
直接说结论：90% 的动态业务逻辑场景，用 govaluate 就够了；它不是万能的，但硬上自研解析器大概率会掉进 AST 构建、变量作用域、短路求值、类型隐式转换这些坑里。
它适合「条件判断为主、动作执行为辅」的规则场景，比如风控策略（user.Score > 80 && user.Level == "VIP"）、优惠券发放条件、工单路由规则。不适合需要复杂流程编排（如分支嵌套、循环、状态持久化）的场景。
-
govaluate默认不支持函数注册（如today()、in_array()），必须手动调用map[string]interface{}注入，且函数返回值类型需严格匹配表达式上下文 - 表达式字符串里不能出现未声明变量，否则
govaluate.NewEvaluableExpression会 panic，建议先用govaluate.GetVariables预检 - 性能上，每次
Evaluate都会重新解析 token，高频调用要缓存govaluate.EvaluableExpression实例，别每次都New
map[string]interface{} 传参时字段缺失导致 panic 怎么办？
常见错误现象：panic: interface conversion: interface {} is nil, not string 或 undefined variable "user.City" —— 这不是规则写错了，是传进去的数据结构和表达式引用的字段对不上。
根本原因是 govaluate 对 nil 值零容忍，且不提供默认值兜底机制。它要求所有被引用的字段在 map 中必须存在（哪怕值为 nil），否则直接报错。
立即学习“go语言免费学习笔记（深入）”；
- 最稳做法：用结构体 +
json.Marshal+json.Unmarshal转成 map，确保字段名全量存在（空字段也会转成nil） - 次选方案：用
maps.Clone（Go 1.21+）或手动遍历 key 补全缺失字段，值设为nil或占位符（如"MISSING"），再传给Evaluate - 千万别在表达式里写
user.Address.Street != ""这种链式访问——user.Address是nil就崩，得拆成两步或改用安全访问函数（需自己注册）
怎么让规则支持「今天」「7天内」这类相对时间？
原生 govaluate 不认识时间函数，但你可以注册一个 now 变量或 daysAgo 函数，关键是得让它「每次 Evaluate 时都实时计算」，而不是初始化时固化。
如果注册成静态变量（比如初始化时 vars["now"] = time.Now()），那规则永远只认启动那一刻的时间，上线后就失效了。
- 推荐注册为函数：
vars["now"] = func() time.Time { return time.Now() }，表达式里写order.CreatedAt.After(now().AddDate(0,0,-7)) - 注意函数返回值类型：如果表达式期望 bool，就注册返回 bool 的函数；如果要参与比较，就返回
time.Time或int64（Unix 时间戳） - 时间比较务必统一时区！
time.Now()是本地时区，数据库时间可能是 UTC，建议全部转成 UTC 后再比，或注册带时区参数的函数（如now("Asia/Shanghai")）
规则配置从 JSON 切到 YAML 后解析失败？
不是 YAML 本身的问题，而是 yaml.Unmarshal 对 map key 的大小写敏感性与 JSON 不同，以及空值处理差异导致的字段丢失。
典型表现：YAML 里写了 user_score: 85，但表达式引用的是 user.Score，结果变量查不到；或者 YAML 中 threshold: 后面没写值，Unmarshal 把它当成了 nil，而 JSON 里 "threshold": null 至少是个 key。
- 统一字段命名风格：规则配置文件里所有变量名用
PascalCase（如UserScore），代码里也按这个来，避免snake_case→camelCase转换出错 - YAML 解析时加
yaml.DisallowUnknownFields()，提前暴露字段映射问题 - 不要依赖
interface{}直接解 YAML，定义明确 struct，用json.RawMessage或yaml.Node做中间层校验字段完整性
govaluate 无关，但线上跑着的每一条规则，背后都是配置发布系统、灰度开关和可观测性埋点。 
