先别猜,先展开
日志或邮件里的 payload 经常是一整行。人眼找缺逗号基本是浪费时间。粘贴进 JSON 格式化:能展开就先看结构;不能展开,工具会指到出问题的位置附近。
常见坑:尾逗号、单引号、截断的字符串、网关返回的 HTML(以 < 开头却被当成 JSON)。Content-Type 写着 json 也不代表 body 真是 json。
Webhook 里常见的两层皮
有的服务把 JSON 再包一层 Base64。先 Base64 解码,再格式化。解码出来仍是乱码,可能根本不是 UTF-8 文本,或密钥/压缩格式搞错了。
body 里带着 JWT 时,复制 token(去掉 Bearer)到 JWT 解码器看 exp、iss。别把签名密钥贴进任何网页工具。
和「上一版契约」对比
今天突然 400,怀疑字段改了:把旧样例和新样例丢进 JSON Diff。类型从 number 变成 string、嵌套对象被拍平,比翻 changelog 快。
同一套步骤每周都在做的话,可在流水线里串:Base64 → JSON 格式化(JWT 需时再手动加一步)。本地处理,适合 staging 数据;生产密钥仍然不要粘。