按指定ID更新Elasticsearch文档字段触发x_content_parse_exception错误

本次报错完全是实现逻辑里对Update API的规则认知错位导致，具体存在三处偏差：

• 混用不同接口的请求参数结构：代码里写的{"_source": {"state": "Success"}}中的_source，是Search查询接口用来控制返回字段范围的参数，根本不适用于文档更新场景。ES的局部字段更新有固定的请求结构要求：所有待修改的字段，必须嵌套在请求体的doc键下，结构和原文档的_source保持一致。
• 文档ID传值不符合Python语法要求：代码里直接写id=pGcGz3gBRea5RG没有给字符串格式的文档ID加引号，Python运行时会把这串无引号的字符识别成未定义的变量，本身就会触发语法层面的报错，和ES接口返回的解析错误形成叠加。
• 传入了已废弃的接口参数：在ES 7.0及以上版本，文档类型概念已经被彻底移除，所有更新操作的默认类型为_doc，不需要显式传入doc_type参数，高版本ES接收该参数会直接抛出“类型已废弃”的错误。

报错的触发逻辑 #

ES服务端接收到错误构造的请求体后，会严格按照Update API的语法规则逐字段解析。你把state字段嵌套在_source对象里的结构，完全不符合Update接口的语法定义，解析到state键时会因为识别不到对应的配置项，抛出Unknown key for a VALUE_STRING in [state]的内容解析异常。

修正后的可正常运行的代码示例 #

elastic_client = Elasticsearch(["http://localhost:9200"])

# 匹配ES Update API规范的请求体结构
query_body = {
    "doc": {
        "state": "Success"
    }
}

elastic_client.update(
    index="Barroz",
    id="pGcGz3gBRea5RG",
    body=query_body
)

内容的提问来源于stack exchange，提问作者Sajeesh Krishnan