接口要求If-Match并返回428,为什么重试原请求还不够?
更新接口返回428,并提示需要If-Match。若只是把原请求再发一遍,缺少的条件仍然缺少,结果通常不会变化。这里要补的是更新依据,而不是单纯等待网络恢复。
2026年11月17日,本文用蜘蛛模拟抓取读取固定428样例,再在本机按“未带条件、带旧条件、带当前条件”比较三组PUT请求。没有修改真实站点数据,也没有模拟多人编辑事故。
428与412表达的阶段不同
公开地址 https://httpbingo.org/status/428 返回固定状态,本次工具正确呈现数字428。GET样例并不验证If-Match,只用于观察工具收到什么响应。

428表示服务端要求请求携带条件,常用于避免基于旧状态直接覆盖资源。条件具体怎么组织,应按接口文档读取资源的验证器后再提交。If-Match不是随手填一个字符串,它需要与服务当前表示的强验证器匹配。
本地演示把当前ETag设为 "v2"。不发送If-Match时返回428;发送 "v1" 时已经有条件,但条件不满足,返回412。这两种失败不能合并成“版本号随便不对”。

第三轮使用当前的 "v2",演示返回200并给出新的 "v3"。本例仅观察条件判断,没有真实并发,也不验证完整的存储事务。

在本机复现三个分支
保存为 server.py 并运行 python3 server.py,另开终端发送PUT。只监听本机8765,用完按Ctrl+C停止;截图自动实验使用随机端口。
from http.server import BaseHTTPRequestHandler, HTTPServer
class Demo(BaseHTTPRequestHandler):
def do_PUT(self):
tag = self.headers.get('If-Match')
code = 428 if tag is None else 200 if tag == '"v2"' else 412
self.send_response(code)
self.send_header('ETag', '"v3"' if code == 200 else '"v2"')
self.send_header('Cache-Control', 'no-store')
self.send_header('Content-Length', '0')
self.end_headers()
HTTPServer(('127.0.0.1', 8765), Demo).serve_forever()
curl -i -X PUT 'http://127.0.0.1:8765/item'
curl -i -X PUT -H 'If-Match: "v1"' 'http://127.0.0.1:8765/item'
curl -i -X PUT -H 'If-Match: "v2"' 'http://127.0.0.1:8765/item'
这个小服务固定当前验证器,没有实现持久化和竞争更新;它用于观察三个响应分支,不能作为生产并发控制方案直接部署。
引号也是字段值的一部分。复制ETag时保留原始格式;也不要把带 W/ 的弱ETag去掉前缀,伪装成强验证器。需要强比较的条件,不能通过编辑标记来得到真实保证。
重新读取之后,还要决定怎么处理旧修改
收到428,可先按接口约定读取资源与当前ETag,再确认要提交的修改。收到412,则说明原先的条件已经没有满足;应重新获取新状态,比较差异,决定合并、放弃或让用户重新确认内容。
不能为了消除报错,就把If-Match改成通配符或直接禁用检查。*有自己的存在性语义,也不是“忽略版本”的普通替代写法。真实服务是否允许它,应按业务约定判断。
自动化监控可以保留读取与提交的关联:对象标识、读取时ETag、提交条件、返回状态和新ETag。若中间被其他请求修改,日志才足以说明为什么没有通过。
网站测速记录到428,说明入口有响应,但还没有证明更新成功。把条件来源补齐,再核对实际结果,才能区分“请求尚缺条件”和“资源确实完成了变更”。