---
title: "分片仅在激活状态时才允许操作 - 如何解决此 Elasticsearch 异常"
date: 2026-03-20
lastmod: 2026-03-20
description: "在 Elasticsearch 中，当对未激活的分片执行操作时会引发此错误。这可能是由于分片正在初始化、迁移或恢复过程中导致的。"
tags: ["分片管理", "异常处理"]
summary: "版本： 6.8-8.9
 简而言之，当在 Elasticsearch 中未激活的分片上尝试执行操作时，会发生此错误。这可能是由于分片正在初始化、迁移或恢复过程中导致的。要解决此问题，您可以在重试操作之前等待分片变为激活状态。或者，您可以检查集群健康状态和分片状态，以识别导致分片未激活的任何潜在问题。如有必要，您可能需要手动重新路由分片或重启 Elasticsearch 节点。
日志上下文 #  日志"operation only allowed when shard is active"（仅在分片激活时才允许操作）的类名为 IndexShard.java。 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的用户参考：
} public void forceMerge(ForceMergeRequest forceMerge) throws IOException { IndexShardState state = this.state; // one time volatile read  if (state != IndexShardState.STARTED) { throw new IllegalIndexShardStateException(shardId; state; "operation only allowed when shard is active"); } logger.trace("force merge with {}"; forceMerge); Engine engine = getEngine(); engine.forceMerge(forceMerge.flush(); forceMerge.maxNumSegments(); forceMerge.onlyExpungeDeletes(); forceMerge."
---



> **版本：** 6.8-8.9


简而言之，当在 Elasticsearch 中未激活的分片上尝试执行操作时，会发生此错误。这可能是由于分片正在初始化、迁移或恢复过程中导致的。要解决此问题，您可以在重试操作之前等待分片变为激活状态。或者，您可以检查集群健康状态和分片状态，以识别导致分片未激活的任何潜在问题。如有必要，您可能需要手动重新路由分片或重启 Elasticsearch 节点。

日志上下文
-----------

日志"operation only allowed when shard is active"（仅在分片激活时才允许操作）的类名为 [IndexShard.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的用户参考：

```java
}  public void forceMerge(ForceMergeRequest forceMerge) throws IOException {
 IndexShardState state = this.state; // one time volatile read
 if (state != IndexShardState.STARTED) {
 throw new IllegalIndexShardStateException(shardId; state; "operation only allowed when shard is active");
 }
 logger.trace("force merge with {}"; forceMerge);
 Engine engine = getEngine();
 engine.forceMerge(forceMerge.flush(); forceMerge.maxNumSegments(); forceMerge.onlyExpungeDeletes(); forceMerge.forceMergeUUID());
 }
```