报错说参数缺失,问题却在网关白名单:一次接口联调的排查
上周联调一个新接口,对方文档写得很清楚:传 user_id 和 page,返回列表。结果一调就报错,提示参数缺失。检查了三遍请求体,两个参数都在,值也没错,报错信息却咬定少了参数。
第一反应是对方的校验写错了,但对方贴出他们收到的请求,user_id 那一栏确实是空的。请求发出去了,参数却在半路丢了,这就不是业务问题了。顺着链路往下查,请求先经过我们这边一个网关层做转发,网关会把请求体重写一遍。重写逻辑里有个白名单,只放行它认识的字段,不认识的直接丢掉。user_id 不在白名单里,于是转发出去的请求就只剩 page 一个参数,对方当然报缺失。
问题找到了,但还有一层:这个接口是上周新加的,白名单却是两个月前配的,新字段没人同步进去。更巧的是,page 因为早就存在所以能过去,user_id 是新加的,偏偏就是它被丢了。报错信息说参数缺失,从现象上看一点没错,只是指错了方向——缺失发生在转发环节,不在调用方。
修复分两步:先把 user_id 加进白名单恢复联调;再把白名单的维护方式改掉,不再靠人工在配置里逐个加字段,改成按接口注册信息自动生成,新增接口上线时白名单跟着一起变。顺手还在网关上加了一条日志:转发前后字段数不一致时打一条警告,以后丢字段至少能第一时间发现。
这次的教训是,接口报错说缺参数,别只盯着调用方看一眼就下结论。请求中间只要经过一层改写,参数就有可能在你看不见的地方被吃掉。联调出问题先把“对方实际收到的请求”拿出来对一遍,能省掉大半猜测。白名单这类人工维护的配置,最怕的就是新增的东西没同步,改成自动生成比靠记性靠谱得多。
- 点赞
- 收藏
- 关注作者
评论(0)