跨系统恢复Elasticsearch快照失败，求正确操作流程

前置检查 #

• 源集群与目标集群的Elasticsearch主版本必须完全一致（例如均为7.17.x，跨大版本直接恢复会触发元数据解析失败）
• 目标集群快照存储目录权限需配置正确：将目录所有权赋予Elasticsearch进程所属用户（通常为elasticsearch），执行命令：

  sudo chown -R elasticsearch:elasticsearch /path/to/target/repo
  

正确恢复流程 #

1. 完整复制快照仓库文件 #

将源集群快照仓库的所有文件（包括index-*元数据文件、分片数据文件）完整复制到目标集群的指定目录，确保无文件遗漏或损坏。

2. 在目标集群注册快照仓库 #

需与源仓库类型（如fs）及核心配置保持一致，执行以下API注册：

PUT /_snapshot/your_repo_name
{
  "type": "fs",
  "settings": {
    "location": "/path/to/target/repo", # 与文件复制路径对应
    "compress": true, # 需和源仓库配置匹配
    "max_snapshot_bytes_per_sec": "50mb",
    "max_restore_bytes_per_sec": "50mb"
  }
}

若源仓库有自定义配置（如chunk_size），需同步添加到目标仓库配置中。

3. 验证快照识别状态 #

执行API确认目标集群已识别到快照：

GET /_snapshot/your_repo_name/_all

返回结果中能看到目标快照名称，即为注册成功。

4. 执行快照恢复 #

根据需求选择恢复范围，示例如下：

• 恢复所有索引（自动忽略不存在的索引，不恢复集群全局状态）：

  POST /_snapshot/your_repo_name/your_snapshot_name/_restore
  {
    "indices": "*",
    "ignore_unavailable": true,
    "include_global_state": false
  }
  

• 若目标集群存在同名索引，可重命名恢复：

  POST /_snapshot/your_repo_name/your_snapshot_name/_restore
  {
    "indices": "*",
    "ignore_unavailable": true,
    "include_global_state": false,
    "rename_pattern": "(.+)",
    "rename_replacement": "restored_$1"
  }
  

5. 监控恢复进度 #

• 查看恢复任务详情：

  GET /_recovery/_all?human
  

• 等待集群状态变为green：

  GET /_cluster/health?wait_for_status=green&timeout=30s
  

常见失败排查点 #

• 版本不兼容：跨大版本恢复会触发元数据解析错误，必须保证主版本一致
• 权限不足：目标仓库目录未赋予Elasticsearch读写权限
• 仓库配置不匹配：源仓库与目标仓库的核心配置（如压缩开关）不一致
• 文件缺失：复制过程中遗漏元数据文件（如index.latest），需重新完整复制

内容的提问来源于stack exchange，提问作者kunal h