报错说参数缺失,问题却在网关白名单:一次接口联调的排查

举报
yd_273280467 发表于 2026/11/18 09:19:37 2026/11/18
【摘要】 联调报错参数缺失,调用方没错,是网关转发时的白名单把新字段 user_id 丢掉了;改成按接口注册自动生成白名单才根治。

上周联调一个新接口,对方文档写得很清楚:传 user_id 和 page,返回列表。结果一调就报错,提示参数缺失。检查了三遍请求体,两个参数都在,值也没错,报错信息却咬定少了参数。

第一反应是对方的校验写错了,但对方贴出他们收到的请求,user_id 那一栏确实是空的。请求发出去了,参数却在半路丢了,这就不是业务问题了。顺着链路往下查,请求先经过我们这边一个网关层做转发,网关会把请求体重写一遍。重写逻辑里有个白名单,只放行它认识的字段,不认识的直接丢掉。user_id 不在白名单里,于是转发出去的请求就只剩 page 一个参数,对方当然报缺失。

问题找到了,但还有一层:这个接口是上周新加的,白名单却是两个月前配的,新字段没人同步进去。更巧的是,page 因为早就存在所以能过去,user_id 是新加的,偏偏就是它被丢了。报错信息说参数缺失,从现象上看一点没错,只是指错了方向——缺失发生在转发环节,不在调用方。

修复分两步:先把 user_id 加进白名单恢复联调;再把白名单的维护方式改掉,不再靠人工在配置里逐个加字段,改成按接口注册信息自动生成,新增接口上线时白名单跟着一起变。顺手还在网关上加了一条日志:转发前后字段数不一致时打一条警告,以后丢字段至少能第一时间发现。

这次的教训是,接口报错说缺参数,别只盯着调用方看一眼就下结论。请求中间只要经过一层改写,参数就有可能在你看不见的地方被吃掉。联调出问题先把“对方实际收到的请求”拿出来对一遍,能省掉大半猜测。白名单这类人工维护的配置,最怕的就是新增的东西没同步,改成自动生成比靠记性靠谱得多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。