适用范围与准备
适用于有文档的配置API、文件或资源更新接口,提交后明确返回412或428。先保留本地未提交修改;本文不会自动重试写操作,也不建议删除版本条件强行覆盖远端。
先区分原因
412表示请求头中的某个前置条件不成立;428表示服务要求请求带条件,常用于防止覆盖其他人的更新。If-Match可以用先前取得的ETag约束更新,但具体接口要求哪些字段,应以其文档为准;这不是换个代理就会消失的连接错误。
按顺序操作
- 先记录方法、资源地址、状态和响应说明,再确认请求是否含If-Match等条件。不要把正文里的普通version字段直接当成HTTP ETag,也不把弱ETag随意改成强ETag。
- 若是428,阅读接口说明并只读获取当前资源及其版本标识,弄清服务要求的条件。若是412,比较此前保存的标识与当前资源,核对是否已经被别人或另一个窗口修改。
- 把本地改动与最新远端内容在副本里比较,明确需要保留的差异。不要仅复制一个新ETag覆盖旧值后立即提交,否则仍可能丢掉别人的修改。
- 确认合并内容和接口语义后,由操作者执行一次必要的更新。遇到网络中断导致结果不明时,先读回资源确认结果,再决定是否重试。
| 现象 | 处理方向 |
|---|---|
| 428:要求条件请求 | 先确认接口条件要求并取得当前标识 |
| 412:已有条件不成立 | 比较资源版本和条件,保留双方修改 |
| 409:资源冲突 | 按具体冲突说明处理,不能只套ETag流程 |
怎样确认有效
成功响应后还要读回同一资源,核对自己的修改已保存且需要保留的远端内容未丢失。只看到HTTP成功或换到新ETag不等于完成业务验收。ETag示例不能跨账号、跨资源复用。
无效时恢复与下一步
继续保留本地副本和最后一次已知远端状态,停止无界重试。向维护者提供时间、方法和脱敏条件信息,不发送访问令牌或整个私有配置;没有合并权限时交资源负责人处理。