适用范围与准备

适用于有文档的配置API、文件或资源更新接口,提交后明确返回412或428。先保留本地未提交修改;本文不会自动重试写操作,也不建议删除版本条件强行覆盖远端。

先区分原因

412表示请求头中的某个前置条件不成立;428表示服务要求请求带条件,常用于防止覆盖其他人的更新。If-Match可以用先前取得的ETag约束更新,但具体接口要求哪些字段,应以其文档为准;这不是换个代理就会消失的连接错误。

按顺序操作

  1. 先记录方法、资源地址、状态和响应说明,再确认请求是否含If-Match等条件。不要把正文里的普通version字段直接当成HTTP ETag,也不把弱ETag随意改成强ETag。
  2. 若是428,阅读接口说明并只读获取当前资源及其版本标识,弄清服务要求的条件。若是412,比较此前保存的标识与当前资源,核对是否已经被别人或另一个窗口修改。
  3. 把本地改动与最新远端内容在副本里比较,明确需要保留的差异。不要仅复制一个新ETag覆盖旧值后立即提交,否则仍可能丢掉别人的修改。
  4. 确认合并内容和接口语义后,由操作者执行一次必要的更新。遇到网络中断导致结果不明时,先读回资源确认结果,再决定是否重试。
现象处理方向
428:要求条件请求先确认接口条件要求并取得当前标识
412:已有条件不成立比较资源版本和条件,保留双方修改
409:资源冲突按具体冲突说明处理,不能只套ETag流程

怎样确认有效

成功响应后还要读回同一资源,核对自己的修改已保存且需要保留的远端内容未丢失。只看到HTTP成功或换到新ETag不等于完成业务验收。ETag示例不能跨账号、跨资源复用。

无效时恢复与下一步

继续保留本地副本和最后一次已知远端状态,停止无界重试。向维护者提供时间、方法和脱敏条件信息,不发送访问令牌或整个私有配置;没有合并权限时交资源负责人处理。