适用版本： 7.17-8.9
1. 错误说明 #
Failed to create security index 表示 Elasticsearch 安全模块在初始化过程中，尝试创建内部安全索引（如 .security-7 或 .security）后，未能收到 acknowledged 确认响应，从而在回调中主动抛出 ElasticsearchException。
该异常并非普通用户索引创建失败，而是安全模块内部初始化流程中的关键步骤未正常完成。
常见现象 #
- 集群启动时安全模块初始化失败，日志中出现
Failed to create security index异常。 - 安全相关功能（如用户认证、角色权限）无法正常使用，甚至可能阻止集群进入 Green 状态。
- 在 Elasticsearch 服务端日志中，可检索到
ElasticsearchException: Failed to create security index及相关调用栈。 - 若为滚动升级或首次开启安全功能，可能伴随
.security索引不存在或状态异常的警告。
典型报错与异常栈 #
常见日志形态通常类似下面这样：
ElasticsearchException: Failed to create security index
at org.elasticsearch.xpack.security.SecurityLifecycleService$1.onResponse(SecurityLifecycleService.java)
Caused by: java.lang.IllegalStateException: Failed to create security index
2. 原因分析 #
结合源码逻辑与安全模块初始化流程，常见原因包括：
- 集群状态不稳定：Master 节点不可用或集群元数据（metadata）更新失败，导致内部索引创建请求无法被正常确认。
- 安全索引名称或模板冲突：已存在同名索引、索引模板设置冲突，或自定义模板覆盖了系统安全索引的创建行为。
- 系统索引权限受限：集群设置了系统索引访问限制（如
system_indices.allowlist配置不当），导致安全模块无权限创建或写入内部索引。 - 磁盘空间不足：数据节点磁盘使用率超过水位线（flood stage），索引创建请求被拒绝。
- 版本升级或配置变更：跨大版本升级后索引格式不兼容，或安全功能首次开启时配置不完整。
3. 解决方案 #
建议按以下步骤逐步排查和修复：
检查集群健康状态与 Master 节点
curl -X GET "localhost:9200/_cluster/health?pretty" curl -X GET "localhost:9200/_cat/master?v"确保 Master 节点可用且集群状态不为 Red。
查看安全模块初始化日志 在 Elasticsearch 日志中搜索关键字
security index或Failed to create security index，确认失败时间与上下文。检查系统索引状态
curl -X GET "localhost:9200/.security*?pretty" curl -X GET "localhost:9200/_cat/indices/.security*?v"确认
.security相关索引是否存在、状态是否正常。检查磁盘空间与水位线
curl -X GET "localhost:9200/_cat/allocation?v"若磁盘使用率超过 90%，需清理空间或扩容后再重试。
确认系统索引权限配置 检查
elasticsearch.yml中是否存在限制性配置：# 若配置了系统索引允许列表，确保包含安全索引 system_indices.allowlist: [".security*"]手动触发安全索引重建（谨慎操作） 若确认数据可丢失，可在停止集群后删除旧的安全索引目录并重新启动，让安全模块重新初始化。
排查时需要注意的问题 #
- 不要仅依赖客户端报错文案，必须结合 Elasticsearch 服务端日志与同一时间窗口内的集群状态指标。
- 若涉及跨版本升级，优先查阅对应版本的官方迁移指南，确认安全索引格式是否发生变化。
- 生产环境操作前，务必在测试环境复现问题并验证修复方案。
4. 预防措施 #
- 建立集群健康监控：对节点状态、磁盘使用率、JVM 内存、线程池和系统索引状态设置告警基线。
- 规范模板与系统索引管理：避免自定义索引模板覆盖系统索引的默认行为，必要时通过
index_patterns明确区分业务索引与系统索引。 - 控制配置变更风险：对安全配置、系统索引权限、磁盘水位线相关参数采用灰度发布与回滚预案。
- 定期备份集群状态：使用快照（Snapshot）功能定期备份集群元数据，以便在异常时快速恢复。
借助 INFINI 产品提升排障效率 #
- INFINI Console 适合查看集群健康度、节点指标、索引状态、错误趋势和请求画像，帮助快速判断安全模块初始化失败是局部问题还是系统性问题。
- INFINI Gateway 适合部署在 Elasticsearch 前面做请求观测、限流与流量治理，减少因瞬时异常导致的连锁故障。
5. 小结 #
Failed to create security index 是安全模块内部初始化失败的关键信号，通常与集群状态、系统索引权限、磁盘资源或配置冲突相关。处理时应优先确认 Master 节点可用性、磁盘空间与系统索引访问权限，再逐步定位具体根因。通过建立完善的监控基线与变更管控流程，可以有效降低此类异常的发生概率。
相关错误 #
附：日志上下文 #
下面保留当前页面中的源码或日志片段，便于继续结合异常调用栈定位问题：
@Override
public void onResponse(CreateIndexResponse createIndexResponse) {
if (createIndexResponse.isAcknowledged()) {
andThen.run();
} else {
consumer.accept(new ElasticsearchException("Failed to create security index"));
}
}
@Override
public void onFailure(Exception e) {
consumer.accept(e);
}
