适用版本： 7.x – 8.x
1. 错误异常的基本描述 #
AUTO_CREATE_INDEX_SETTING getKey 异常在 Elasticsearch 尝试自动创建索引、但 action.auto_create_index 配置禁止该行为时触发。该异常的核心含义是：请求的目标索引不存在，而集群的自动创建索引策略又不允许为该索引（或该模式匹配的索引）执行自动创建，因此 Elasticsearch 抛出 IndexNotFoundException 并拒绝请求。
常见现象 #
- 写入或查询不存在的索引时，客户端收到
404 IndexNotFoundException或400错误响应。 - 应用日志中出现类似
IndexNotFoundException: [action.auto_create_index] contains [...] which forbids automatic creation of the index的错误信息。 - 使用通配符索引模式（如
logs-*）时，若匹配的新索引被自动创建策略排除，则首次请求即失败。 - Elasticsearch 服务端日志中可看到与
AUTO_CREATE_INDEX_SETTING相关的异常堆栈。
典型报错与异常栈 #
org.elasticsearch.index.IndexNotFoundException: [action.auto_create_index] contains [-logs-2026-06] which forbids automatic creation of the index
at org.elasticsearch.cluster.metadata.MetadataAutoIndexService.validateAutoCreateIndex(MetadataAutoIndexService.java:...)
at org.elasticsearch.cluster.metadata.MetadataAutoIndexService.findMatchingIndices(MetadataAutoIndexService.java:...)
或另一种常见形式：
org.elasticsearch.index.IndexNotFoundException: [action.auto_create_index] ([-*]) doesn't match
at org.elasticsearch.cluster.metadata.MetadataAutoIndexService.evaluateAutoCreateIndex(MetadataAutoIndexService.java:...)
2. 为什么会发生这个错误 #
该异常的根本原因是：请求的目标索引不存在，且 action.auto_create_index 设置不允许自动创建该索引。具体触发场景包括：
action.auto_create_index被设为false：集群完全禁用了自动创建索引功能，任何指向不存在索引的请求都会失败。- 自动创建策略显式排除了目标索引：
action.auto_create_index配置了允许/拒绝列表（如+logs-*、-*），而当前请求的索引恰好被拒绝规则匹配。 - 索引名称含特殊字符或命名不符合策略：索引名不在允许模式范围内，导致自动创建被拦截。
- 索引模板未预先创建：依赖自动创建索引但相关索引模板尚未配置，而自动创建又被禁用，形成矛盾。
- 跨集群访问场景：通过跨集群搜索（CCS）访问远程集群时，远程集群的自动创建策略与本地请求不匹配。
3. 如何排查这个异常 #
建议按以下顺序排查：
确认报错的索引名称：从异常信息中提取完整索引名，确认该索引是否预期存在。
检查索引是否存在：执行
GET /_cat/indices/<index_name>?v确认索引是否已被创建。查看自动创建索引配置：执行以下命令获取当前配置：
GET /_cluster/settings?flat_settings=true&include_defaults=true在返回结果中查找
action.auto_create_index的值。判断匹配规则：若配置值为一个逗号分隔的模式列表（如
+logs-*,-*），需确认目标索引名是否被允许规则（+）匹配，且未被拒绝规则（-）覆盖。检查索引模板：执行
GET /_index_template/<template_name>确认是否有匹配的模板可以覆盖该索引的创建行为。
排查时需要注意的问题 #
action.auto_create_index的默认值为true（允许所有索引自动创建），若被修改为具体模式列表，规则按从左到右顺序匹配，首个匹配项决定结果。- 拒绝规则（以
-开头）的优先级高于允许规则（以+开头），需注意规则顺序。 - 若使用 Logstash、Beats 等数据摄入组件，需确保写入的索引模式已被加入允许列表。
4. 如何解决这个错误 #
方案一：启用或调整自动创建索引配置 #
若希望恢复自动创建索引能力，可通过集群设置调整：
# 完全启用自动创建索引（适用于开发/测试环境）
PUT /_cluster/settings
{
"persistent": {
"action.auto_create_index": "true"
}
}
# 或仅允许特定模式的索引自动创建（推荐生产环境）
PUT /_cluster/settings
{
"persistent": {
"action.auto_create_index": "+logs-*,+metrics-*,+*,-."
}
}
说明：
+表示允许，-表示禁止。上述配置表示允许logs-*和metrics-*开头的索引自动创建，禁止其他所有索引。
方案二：手动预创建索引 #
若出于安全考虑不希望开启自动创建，可在写入前手动创建索引：
PUT /logs-2026-06-11
{
"settings": {
"number_of_shards": 1,
"number_of_replicas": 1
}
}
结合索引模板使用效果更佳——先创建模板，再让索引按模板自动或手动创建：
PUT /_index_template/logs_template
{
"index_patterns": ["logs-*"],
"template": {
"settings": {
"number_of_shards": 1
}
}
}
方案三：在应用侧避免写入不存在的索引 #
- 在写入前先检查索引是否存在，不存在则创建。
- 使用日期轮换索引时，提前通过定时任务创建下一周期的索引。
- 使用 Elasticsearch 的 ILM（索引生命周期管理）功能，通过滚动别名管理索引创建。
后续注意事项与推荐建议 #
- 生产环境建议显式配置
action.auto_create_index，避免使用默认的true，以减少意外索引被创建的风险。 - 结合索引模板使用：即使开启自动创建，也应预先配置索引模板，确保新索引的 mapping 和 settings 符合预期。
- 使用 ILM + 索引别名：通过
logs-write别名指向当前写入索引，配合 ILM 自动滚动，可完全避免依赖自动创建索引。 - 监控索引创建行为：通过 INFINI Console 监控集群中索引的创建来源，及时发现异常索引。
借助 INFINI 产品提升排障效率 #
- INFINI Console 适合查看集群健康度、索引创建趋势、模板配置和集群设置，帮助快速确认
action.auto_create_index的当前值及其影响范围。 - INFINI Gateway 可部署在 Elasticsearch 前端，对写入请求进行预处理——当检测到目标索引不存在且自动创建被禁用时，可提前拦截并返回更友好的错误提示，或自动补全索引创建逻辑。
5. 小结 #
AUTO_CREATE_INDEX_SETTING getKey 异常的本质是索引自动创建策略与请求目标不匹配。解决思路有三种：调整自动创建策略以允许目标索引、手动预创建索引、或在应用侧规避写入不存在的索引。在生产环境中，推荐采用"显式配置自动创建规则 + 索引模板 + ILM"的组合方案，在保障安全性的同时维持系统的可维护性。
相关错误 #
- index-not-found-in-repository：索引未找到
- illegal-argument-exception：非法参数异常
- configuration-exception：配置异常
- auto-create-index-setting-getkey-is-false：自动创建索引设置为false
附：日志上下文 #
以下为触发该异常的典型 Java 源码逻辑，便于理解异常抛出的上下文：
// MetadataAutoIndexService.java
if (autoCreate.isFalse(index)) {
throw new IndexNotFoundException(
"[" + AUTO_CREATE_INDEX_SETTING.getKey() + "] contains [-"
+ indexExpression + "] which forbids automatic creation of the index",
index
);
}
throw new IndexNotFoundException(
"[" + AUTO_CREATE_INDEX_SETTING.getKey() + "] ([" + autoCreate
+ "]) doesn't match",
index
);
