适用版本： 7-8.9
1. 错误异常的基本描述 #
[auto_create_index] is [false] 表示 Elasticsearch 在接收到对不存在索引的写请求时，原本可以执行自动建索引，但集群级设置 action.auto_create_index 被明确关闭，因此直接拒绝创建并抛出 IndexNotFoundException。
常见现象 #
- 首次写入新索引时失败，但对已存在索引的写入正常。
- 应用、Beats、Logstash 或自定义采集程序依赖“写入即建索引”逻辑，升级或变更后突然报错。
- 目标索引不存在，且没有模板级例外允许它被自动创建。
典型报错与异常栈 #
org.elasticsearch.index.IndexNotFoundException: no such index [logs-2026.03.31] and [action.auto_create_index] is [false]
2. 为什么会发生这个错误 #
这是最直接的自动建索引拦截场景: 集群级配置已经关闭自动创建。常见原因包括：
- 运维为防止误建索引，主动将
action.auto_create_index设为false。 - 环境迁移后，旧业务仍假设 Elasticsearch 会自动建索引。
- 发布流程改成“必须先建模板和索引”，但上游写入逻辑没有同步调整。
- 某些索引初始化步骤失败，导致首次写入只能依赖自动创建，而当前集群不允许。
3. 如何排查和解决这个异常和解决这个异常 #
先确认是否真的是集群级 auto create 被关闭，而不是模板或 pattern 规则限制。
- 查看集群设置：
GET /_cluster/settings?include_defaults=true
- 检查
action.auto_create_index当前值是false还是其他 pattern 规则。 - 确认目标索引是否本应由初始化流程显式创建。
- 查看最近集群配置变更，确认是否是某次运维调整后开始报错。
- 如果上游程序依赖自动建索引，确认是否需要在应用发布前补上索引创建步骤。
排查时需要注意的问题 #
- 这类错误是配置决策，不一定是故障。很多集群就是故意关闭自动建索引。
- 不要为了临时消除报错就全局开启自动建索引，先评估是否会引入误建索引风险。
- 如果存在模板或数据流初始化流程，优先保证显式创建链路正确，而不是依赖隐式自动创建。
4. 如何解决这个错误 #
常用修复思路 #
- 如果业务允许自动建索引，可调整
action.auto_create_index。 - 如果不应开启全局自动创建，改为在发布或启动流程中显式创建索引或数据流。
- 如果只有特定索引前缀需要自动创建，可用 pattern 规则代替全局
false。 - 为采集程序和业务写入链路增加启动前检查，避免首次写入才暴露问题。
相关 Elasticsearch API #
GET /_cluster/settings?include_defaults=true：查看当前 auto create 设置。PUT /_cluster/settings：更新action.auto_create_index。PUT /{index}：显式创建索引。
借助 INFINI 产品提升排障效率 #
- INFINI Console 可帮助追踪集群设置变更、索引创建失败趋势和写入来源。
- INFINI Gateway 可快速识别哪些客户端仍然依赖自动建索引。
5. 小结 #
[auto_create_index] is [false] 的根因很明确: 集群级自动建索引被关闭。处理时先确认这是预期策略还是配置漂移，再在“显式建索引”与“调整 auto create 设置”之间做选择。
附：日志上下文 #
[auto_create_index] is [false]
Caused by: IndexNotFoundException
