应用Elasticsearch Ingest Pipeline时遇parse_exception：请求体或source参数缺失

执行以下PUT请求创建Ingest Pipeline：

PUT _ingest/pipeline/add_test_pipeline
{
  "description": "A description for your pipeline",
  "processors": [
    {
      "set": {
        "field": "fieldname",
        "value": "1"
      }
    }
  ]
}

返回400错误：

{
  "error" : {
    "root_cause" : [
      {
        "type" : "parse_exception",
        "reason" : "request body or source parameter is required"
      }
    ],
    "type" : "parse_exception",
    "reason" : "request body or source parameter is required"
  },
  "status" : 400
}

该请求在某Elasticsearch集群可正常执行，但在另一个集群失败。以下是针对性的排查和解决方向：

• 检查请求发送的完整性与格式

  • 若使用curl命令，确保正确携带请求体并设置请求头，示例命令：

    curl -X PUT "http://<目标集群地址>:9200/_ingest/pipeline/add_test_pipeline" -H "Content-Type: application/json" -d '{
      "description": "A description for your pipeline",
      "processors": [
        {
          "set": {
            "field": "fieldname",
            "value": "1"
          }
        }
      ]
    }'
    

    重点确认：添加Content-Type: application/json请求头，用-d参数正确传递JSON内容，避免引号转义错误（Windows环境需调整引号格式）。
  • 若使用Kibana Dev Tools等GUI工具，检查是否误删请求体，或工具存在缓存/配置异常，尝试重新粘贴请求后发送。

• 排查目标集群的安全与配置限制

  • 检查目标集群是否有防火墙、WAF或网关设备，这类设备可能拦截或修改请求体，导致Elasticsearch无法接收完整内容。
  • 查看目标集群的elasticsearch.yml配置文件，确认是否有HTTP相关限制，比如是否启用安全插件（如Elastic Security），需验证用户权限是否足够，以及插件是否对请求格式有额外校验。
  • 查看目标集群的Elasticsearch日志，获取更详细的错误信息，定位请求体未被正确接收的原因。

• 验证集群版本兼容性

  • 确认两个集群的Elasticsearch版本是否一致，部分旧版本对请求头要求更严格，必须明确指定Content-Type: application/json，否则会触发请求体缺失的错误。

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