Aeron Archive异常关闭后如何标记录制为非活跃以重放/扩展？

当Aeron归档进程因kill -9终止或崩溃导致录制仍处于活跃状态时，可通过以下两种方式标记其为非活跃：

方式一：使用官方命令行工具（推荐） #

Aeron提供的aeron-archive-cli工具可以直接修改录制状态，步骤如下：

• 先列出所有录制条目，定位目标录制的recordingId：

  aeron-archive-cli list-recordings
  

• 执行标记命令，指定录制ID和准确的stopPosition（可通过录制起始位置+已写入文件的字节数推算，或从相关日志获取）：

  aeron-archive-cli mark-recording-inactive <recordingId> <stopPosition>
  

  注意：stopPosition必须大于等于该录制的startPosition，务必使用实际终止时的准确位置，避免重放时出现数据不完整或错误。

方式二：手动修正归档元数据（应急方案） #

若命令行工具无法正常工作，可直接修改归档元数据文件（操作前务必备份）：

• 找到归档目录下的archive-recording-meta.dat文件（默认路径通常为./aeron-archive/data）
• 使用Aeron提供的元数据解析工具或二进制编辑器，定位目标录制条目，将状态从ACTIVE修改为INACTIVE，同时填充正确的stopPosition值
• 修改完成后重启归档服务，该录制会被识别为非活跃状态

验证操作 #

执行list-recordings命令，确认目标录制的状态已变为INACTIVE且stopPosition已正确设置，之后即可正常执行重放或扩展操作。

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