接口日志保留怎么定？

接口日志保留要能支撑异常追溯。春喜铜平台的接口常涉及客户资料、订单、库存、审批、企微通知和报表数据。接口当时调通不代表后面不会出问题，字段变化、重复推送、超时、部分成功和对方系统维护，都会让两边数据不一致。

日志先分业务风险

普通通知类接口可以保留较短周期，但订单、库存、客户、价格、财务、质检和售后相关接口要保留更长时间。保留周期不能只按技术存储压力定，要看业务争议和复盘周期。

接口类型	日志重点
通知提醒	推送对象、时间、状态、失败原因
订单库存	业务单号、请求响应、重试记录、写入结果
客户价格	字段前后值、授权来源、审批依据
文件附件	文件名、大小、来源、下载或同步结果
财务质量	操作依据、接口批次、异常处理记录

涉及客户承诺、库存调整和财务结算的接口，日志至少要保留到业务复盘和账务核对结束后。

日志字段要能还原过程

接口日志至少记录接口名称、来源系统、目标系统、传输方向、业务单号、请求时间、响应时间、请求摘要、响应摘要、状态码、错误信息、重试次数、处理人和人工介入记录。

敏感字段不一定完整明文保存，但要能判断发生了什么。需要脱敏的内容，可以保留字段名、摘要、哈希或变更标记，避免日志本身变成数据泄露入口。

失败和重试要能串起来

同一业务单号的首次请求、失败、重试、人工补录和最终成功，要能在日志里串成一条链。不要让每次重试都像一个新问题，否则后续会误以为重复下单、重复通知或重复入库。

接口上线或变更关闭前，应检查日志是否能覆盖正常成功、失败、超时、重复、部分成功和人工处理几类场景。日志保留的目标，是异常发生后不用靠人回忆当时系统做了什么。