联调与排错技巧

接口问题大多可归结为：路径、参数、鉴权、环境、数据五类。

最小复现三步

1. 用 curl/Postman 绕过业务前端，确认是不是客户端问题
2. 打印完整 URL、请求头、请求体、响应体
3. 对比文档示例，找出第一个不一致的字段

常见坑

• 编码：中文未 URL Encode，或 JSON 与 form 混用。
• 时间单位：秒/毫秒搞反，导致全是 1970 或远未来时间。
• 环境串了：测试 Token 打到生产，或域名指错。
• 缓存：CDN/浏览器缓存了旧响应，看起来像「改了不生效」。
• 代理头：拿错客户端 IP，风控与限流表现异常。

日志建议

为每次请求生成 request_id，在网关、应用、客户端错误提示中透传。 排障时按 request_id 串联，比只靠时间戳搜索高效得多。