Postman调用Elasticsearch _bulk接口时遇JSON语法错误求助

先明确_bulk的核心格式规则 #

_bulk接口要求每行一个独立JSON对象，严格用换行分隔，绝对不能用数组包裹内容，也不能把操作指令和文档数据放在同一行，固定结构是：

• 第1行：操作元数据（比如index/create/update，可指定索引、文档ID等）
• 第2行：对应文档的具体数据
• 多文档操作就重复上述两行的结构

Postman 具体配置步骤 #

1. 请求基础设置

   • 请求方法选 POST 或 PUT
   • URL填写 http://你的ES地址:端口/目标索引名/_bulk（如果要跨多个索引操作，去掉索引名直接用 /_bulk）

2. Headers 必加配置
   一定要添加 Content-Type: application/x-ndjson，这是绝大多数人踩的坑！用默认的application/json格式必然会报错。

3. 请求体正确写法（可直接参考修改）
   切换到Body的raw模式，输入以下格式内容，注意每行独立，不要加多余的逗号或括号：

   {"index": {"_id": "1"}}
   {"title": "测试文档1", "content": "批量插入的第一条数据"}
   {"index": {"_id": "2"}}
   {"title": "测试文档2", "content": "批量插入的第二条数据"}
   

常见错误排查点 #

• 不要用数组包裹所有内容（比如[{}, {}, {}]），这是单文档插入的格式，和_bulk接口不兼容
• 检查每行JSON的语法，避免少引号、多逗号，确保每个JSON都是完整可解析的
• 最后一行不要留空，部分编辑器自动添加的空行会导致ES解析失败
• Windows系统的换行符\r\n一般可兼容，但尽量使用\n（Postman中直接按回车即可）

快速验证方法 #

如果仍不确定格式是否正确，先尝试插入单条文档测试，格式如下，成功后再扩展多条：

{"index": {}}
{"field1": "test_value"}

内容的提问来源于stack exchange，提问作者L. Kvri