如何将Lucene 5.1.0生成的FST文件迁移适配至Lucene 8.9.0

你遇到的报错是因为Lucene不同大版本之间的FST格式不向下兼容：

org.apache.lucene.index.IndexFormatTooOldException: Format version is not supported (resource org.apache.lucene.store.InputStreamDataInput@34ce8af7): 4 (needs to be between 6 and 7). This version of Lucene only supports indexes created with release 6.0 and later.

Lucene 8.9.0仅支持6.0及以上版本生成的FST格式，5.1.0输出的FST版本号为4，不在兼容范围内，官方没有提供直接的格式转换工具，可通过以下两种方案完成升级：

方案一：双版本中间转换（最稳妥，适配所有场景） #

• 第一步：搭建临时工具工程，仅引入Lucene 5.1.0依赖，读取所有旧版FST文件，遍历导出FST中存储的全量KV数据为JSON、CSV等通用格式的中间文件。
• 第二步：切换到Lucene 8.9.0的目标工程，读取中间文件的全量数据，按照8.9.0版本的FST构建规则重新生成新的FST文件即可。
  注意：如果FST存储的是自定义结构数据，需要保证导出、导入环节的序列化/反序列化逻辑完全一致，避免数据错乱

方案二：梯度版本升级（仅适配FST与Lucene索引绑定的场景） #

如果你的FST是伴随Lucene索引一同生成的，也可以走梯度升级路径：

• 先把Lucene版本从5.1.0升级到6.x版本，调用该版本自带的IndexUpgrader工具，把索引和对应的FST格式升级到6.x支持的版本
• 再把Lucene版本从6.x升级到8.9.0，再次调用对应版本的IndexUpgrader工具完成最终格式升级

注意事项 #

• 不要尝试直接修改FST文件的版本号字段绕过校验，Lucene不同大版本的FST编码逻辑、压缩规则都有调整，强行修改版本号只会触发后续的解析异常。
• 转换完成后建议抽取部分样本做查询结果比对，确认新FST的输出和旧版完全一致再上线使用。

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