报价系统有个"自定义折扣公式"功能,是运营提的需求:不同客户走不同折扣,改一次公式要发一次版,太慢。第一版实现很省事,把表达式字符串丢进 eval,算出来一个数。跑了大半年没出事,我甚至在周报里把它写成"灵活的规则引擎"。转折发生在某个周一:运营在公式里加了个千分位逗号,又在说明文字里打了个中文引号,整段一起粘进了输入框。页面白屏,接口 500。
下面拿数据鱼API的「科学表达式计算」服务当例子。它只有一个 calculate 端点,把"算一个式子"这件事收成一条请求,正好用来讲清楚求值该放在哪。
骂 eval 的文章很多,讲的都是执行任意代码。这个风险是真的,但在业务系统里更常见的翻车方式很朴素:输入里混进了不该有的字符,报错信息直奔屏幕,用户看到一屏英文堆栈。语法错误、类型错误、空值、全角符号,任何一种都能让进程走进异常分支。
根子在于 eval 是语言特性,不是计算器。它的输入域是"任何表达式",而业务需要的输入域是"加减乘除加括号加数字"。这两者的差集,就是你要自己兜的边界。与其在业务代码里用正则一遍遍过滤,不如把求值挪到一个固定入口,业务侧只负责把字符串递出去。
那次翻车之后我复盘了一遍:我们真正想禁的是"不属于计算的东西",用的却是一个黑名单,黑名单永远会漏。数据鱼这个端点的入参就叫 expression,语义上只接受一个式子,业务侧不用再跟产品解释"这到底是公式还是一段脚本"。名字起对了,争论就少一半。
calculate 只要一个必填参数 expression,GET 和 POST 都支持。GET 把表达式放 query,等于号、加号、百分号都得先 encode;POST 放 JSON body 或表单,参数名一致,干净得多。给运营用的表单,我一律走 POST。
传参方式 | 写法 | 适合的场景 |
|---|---|---|
GET | expression 放 query | 调试、手工验证、贴进浏览器 |
POST JSON | {"expression": "..."} | 表单提交、含特殊字符的表达式 |
POST 表单 | 字段名同为 expression | 老系统对接、不方便发 JSON |
返回只有两个字段:expression 回显你传入的式子,result 是算出来的数。缺参数是 4001,格式非法是 4002,这类参数错误不该被当成服务故障去报警,处理方式就是给用户一句"公式写得不对,检查一下括号"。
用了一阵子我发现,result 反而是次要的,expression 回显更值钱。运营报"这个客户折扣算错了",点开记录一看,expression 里写的是 0.85*0.9,但他以为写的是 0.85*0.9%。没有回显,这种争执只能靠猜。
还有两个必须自己处理的坑。一是浮点:0.1+0.2 这类式子算出来是长长的小数,展示前自己 round,别让用户看到后面十几位。二是单位:这个接口只算数,不带量纲,含单位的换算要在业务层做完再传进去。接口把求值这件事收干净,剩下的判断还是你的。
现在运营改公式,我只做一件事:把字符串转手发给数据鱼API的求值接口,把 expression 和 result 一起存进变更记录。业务代码里再没有 eval 了。数据鱼这套接口的价值不在它算得多快,而在它把"算"和"看"分开了——算错的时候,你能看见到底传了什么进去。
以上端点、参数与响应字段,整理自数据鱼API「科学表达式计算」接口的公开文档;文中场景为虚构示例,涉及金额的公式请另做精度与取整约定。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。