
本文介绍如何在 go 应用中集成轻量、安全、类型友好的表达式引擎(如 expr),实现运行时用户自定义配置逻辑(如条件过滤、动态计算),并支持与数据库查询协同工作。
本文介绍如何在 go 应用中集成轻量、安全、类型友好的表达式引擎(如 expr),实现运行时用户自定义配置逻辑(如条件过滤、动态计算),并支持与数据库查询协同工作。
在构建可配置化、面向终端用户的系统(如运营后台、A/B 测试平台或规则引擎)时,常需支持“运行时动态表达式”能力:用户基于预设数据结构(如 user, order, article)编写布尔逻辑或计算表达式,系统即时求值并影响行为(如是否展示某模块、是否触发告警)。Go 原生不提供类似 Java EL 或 JavaScript 的内建表达式支持,但社区已有成熟、生产就绪的解决方案——其中 github.com/antonmedv/expr 是当前最推荐的选择。
为什么选择 expr?
- ✅ 零依赖、纯 Go 实现:无 CGO,跨平台编译友好;
- ✅ 强类型安全:内置静态类型检查器,可在求值前捕获
user.Name + 42等类型错误; - ✅ 清晰错误定位:报错带源码位置标记(如
| user.Age > "18" | -----------^),大幅提升调试效率; - ✅ 安全沙箱设计:默认禁用反射、全局变量、函数调用(除非显式注册),天然防御任意代码执行风险;
- ✅ 语法简洁贴近现代语言:支持
in,not in,all(),any(),len(), 比较运算、嵌套属性访问等。
快速上手示例
假设你从数据库加载了一条用户记录,并希望根据用户输入的表达式动态判断是否启用高级功能:
package main
import (
"fmt"
"github.com/antonmedv/expr"
"github.com/antonmedv/expr/vm"
)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Group string `json:"group"`
Age int `json:"age"`
IsActive bool `json:"is_active"`
}
func main() {
user := User{
ID: 1001,
Name: "Alice",
Group: "premium",
Age: 28,
IsActive: true,
}
// 用户提交的表达式(来自 Web 表单或配置中心)
exprStr := `user.Group in ["premium", "vip"] and user.Age >= 18 and user.IsActive`
// 构建环境:将变量名映射到实际值
env := map[string]interface{}{
"user": user,
}
// 编译(一次)+ 求值(多次)
program, err := expr.Compile(exprStr, expr.Env(env))
if err != nil {
panic(fmt.Sprintf("compile error: %v", err))
}
output, err := expr.Run(program, env)
if err != nil {
panic(fmt.Sprintf("run error: %v", err))
}
fmt.Printf("Expression result: %t\n", output) // true
}
与 PostgreSQL 协同的实用模式
注意:expr 不直接生成 SQL,它运行于应用层,用于 后置过滤 或 决策逻辑。典型协作模式如下:
-
前置数据库查询(高效筛选):用 SQL 查询出候选集(如
SELECT * FROM users WHERE status = 'active'); -
应用层动态过滤(灵活逻辑):对结果切片逐项调用
expr.Run(),执行用户定义的精细规则(如user.Score > 90 and user.Tags contains "vip"); -
组合使用提升性能:可将高频、可下推的条件(如
created_at > '2024-01-01')保留在 SQL 中,仅将动态、低频、含复杂函数的逻辑交给expr。
⚠️ 安全提醒:绝不可将用户输入的表达式未经校验直接传入
expr.Compile()。建议:
- 白名单限制可用字段(通过
expr.Allow()或自定义ExprValidator);- 设置超时(
expr.Program.WithTimeout(100 * time.Millisecond));- 禁用危险操作(默认已禁用
eval,reflect,os等);- 对敏感环境(如金融风控),启用
expr.Optimize()提升执行效率。
总结
expr 是 Go 生态中平衡安全性、易用性与表现力的最佳表达式引擎之一。它不试图替代 SQL,而是精准补位——在数据已加载至内存后,赋予业务层“用户可编程”的逻辑能力。结合结构化数据模型与严谨的环境隔离,你可以在保证系统稳定性的前提下,快速交付高度灵活的配置化功能。从今日起,让你的 Go 服务真正“读懂用户意图”。










