为什么elasticsearch写入失败

Elasticsearch 写入失败的原因很多，通常需要结合错误日志 / 返回信息来判断。下面按常见原因 → 表现 → 排查方式系统说明。

一、集群层面问题（最常见）

1. 集群状态为 RED / YELLOW

• 原因：主分片未分配、磁盘水位超限
• 表现：
  • cluster_block_exception
  • index read-only / allow delete
• 排查：

GET _cluster/health
GET _cat/allocation?v

• 解决：
  • 释放磁盘空间
  • 调整水位：

cluster.routing.allocation.disk.watermark.low: 85%
cluster.routing.allocation.disk.watermark.high: 90%

2. 磁盘写满（ Flood Stage ）

• 表现：

index [xxx] blocked by: [FORBIDDEN/12/index read-only / allow delete]

• 解决：

PUT _all/_settings
{
  "index.blocks.read_only_allow_delete": null
}

二、索引 / Mapping 问题

3. Mapping 冲突

• 原因：字段类型不一致
• 示例：
  • 第一次：age: integer
  • 第二次：age: "18"（字符串）
• 错误：

mapper_parsing_exception

• 解决：
  • 显式定义 mapping
  • 或使用 ignore_malformed

4. 字段超长 / 数组嵌套过深

• 错误：

illegal_argument_exception
limit of total fields [1000] has been exceeded

• 解决：

PUT index/_settings
{
  "index.mapping.total_fields.limit": 2000
}

三、写入方式 / 客户端问题

5. Bulk 写入部分失败

• 表现：
  • HTTP 200，但 errors: true
• 排查：

POST _bulk
{ "index": { "_index": "test" } }
{ "field": "value" }

看 items[].status

6. 文档 ID / 路由问题

• 自定义 routing 但分片计算失败
• 文档大小超过 http.max_content_length

四、权限 / 安全

7. 鉴权失败

• 开启 security 后：
  • 无写入权限
  • token 过期
• 错误：

security_exception

五、资源 / 性能问题

8. 写入被拒绝（Rejected）

• 原因：
  • 线程池满（write / bulk）
• 排查：

GET _nodes/stats/thread_pool

• 表现：

es_rejected_execution_exception

六、快速定位清单（建议按顺序）

1. 看返回的错误信息（最重要）
2. GET _cluster/health
3. GET _cat/indices?v
4. 看 Elasticsearch 日志
5. 检查磁盘、内存、线程池
6. 检查 mapping 和字段类型

如果你愿意，可以把具体的报错信息或写入方式（curl / Java / Logstash / Filebeat）发出来，我可以直接帮你定位是哪一类问题。