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),否则直接报错。
- 最稳做法:用结构体 +
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 无关,但线上跑着的每一条规则,背后都是配置发布系统、灰度开关和可观测性埋点。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











