使用何种HTTP响应可通知客户端响应缺失部分匹配元素？

首先明确：这个场景没有完全匹配的标准HTTP状态码，不要硬套现有非200状态码，也完全可以通过响应头实现通知，具体落地方式如下：

• 主状态码固定用200 OK：你的服务端已经成功接收、处理了请求，也返回了当前可公开给客户端的合法结果，只是部分匹配筛选条件的元素因为各种原因（权限拦截、查询超时截断、数据归档下线、敏感内容过滤等）没有出现在本次响应里，完全符合200的语义。不要乱用其他标准状态码：
  • 别用206 Partial Content：这个状态码是专门给HTTP Range分块下载场景设计的，语义是返回的是请求资源的指定字节段，和业务层面的筛选结果缺失完全无关，乱用会导致HTTP客户端、代理缓存触发错误的分块续传逻辑。
  • 别用207 Multi-Status：这个是WebDAV协议专属的状态码，普通REST接口使用会大幅增加客户端的理解和适配成本。
  • 别用4xx/5xx状态码：403/404/422这类状态码的语义是请求本身有问题、或者整个目标资源不存在，会被中间代理、缓存层判定为错误响应，甚至直接缓存错误结果，影响后续正常请求。
• 自定义响应头实现快速通知：可以定义业务专用的响应头做标记，最简洁的实现是加X-Results-Incomplete: true，如果需要传递更细节的原因，可以再加补充头，比如X-Missing-Reason: permission_filter,query_timeout，客户端不需要解析响应体，只需要读取响应头就能快速知道本次返回的结果不全。
• 响应体同步标记（推荐补充）：如果客户端本来就需要解析响应体，最好在响应的元数据区同步标记该状态，比如在返回结构里增加incomplete_results: true字段，搭配missing_details字段说明具体缺失原因、缺失条目量级等信息，比单纯响应头能传递更丰富的上下文。

注意：如果你的接口是公开给第三方调用的，一定要在接口文档里明确说明这个自定义头、响应字段的语义，避免客户端开发者忽略该提示，误以为拿到了筛选条件下的全量结果。

内容的提问来源于stack exchange，提问作者Tarik Kaoukab