如何将嵌入式ActiveMQ Artemis从1.5.6迁移至2.7.0并解决日志兼容问题

你遇到的问题根源是ARTEMIS-1009引入了日志存储格式的重大破坏性变更，1.x版本的持久化日志和2.x版本不兼容，直接复用旧目录启动2.7.0就会触发这个IllegalStateException。要实现无数据丢失的迁移，需要通过「导出旧数据→初始化新服务器→导入数据」的流程来完成，具体步骤如下：

步骤1：用1.5.6版本导出所有消息数据 #

首先要确保你的旧1.5.6嵌入式服务器能正常启动（如果已经停止，用原1.5.6的代码重新启动），然后通过Artemis的管理API导出消息到XML文件：

// 获取1.5.6版本服务器的控制实例
ActiveMQServer oldServer = ...; // 你的旧EmbeddedJMS对应的server实例
ActiveMQServerControl serverControl = oldServer.getActiveMQServerControl();

// 导出所有消息到指定路径的XML文件
String exportFilePath = persistenceLocation + "exported-messages.xml";
serverControl.exportMessages(exportFilePath);

导出完成后，停止旧服务器，确保没有新的消息生产或消费操作。

步骤2：清理旧持久化目录并初始化2.7.0服务器结构 #

删除旧持久化目录（bindings、journal、paging、largemessages）下的所有内容，然后用你提供的2.7.0版本启动代码启动一次服务器——这一步是让新版本创建兼容2.x格式的空持久化结构，启动成功后立即停止服务器。

步骤3：在2.7.0版本中导入导出的数据 #

修改你的2.7.0启动代码，在服务器启动成功后，调用管理API导入之前导出的XML数据：

// 初始化并启动2.7.0版本服务器
EmbeddedJMS newServer = new EmbeddedJMS();
// ... 你的原有配置代码（设置目录、队列、权限等） ...
newServer.start();

// 获取服务器控制实例并导入数据
ActiveMQServerControl newServerControl = newServer.getActiveMQServer().getActiveMQServerControl();
String exportFilePath = persistenceLocation + "exported-messages.xml";
newServerControl.importMessages(exportFilePath);

导入完成后，你的2.7.0服务器就会包含旧版本的所有消息数据了。

额外注意事项 #

• 导出和导入过程中，要确保服务器没有被其他进程操作（比如临时禁止生产消费），避免数据不一致。
• 检查导出的XML文件，确认包含你需要的队列配置和消息内容，避免遗漏。
• 如果你的队列权限、地址设置在2.7.0版本中有调整，请先在新版本配置中同步这些规则，再执行导入操作，避免导入后队列配置异常。
• 若不想通过代码API操作，也可以用ActiveMQ Artemis独立版的命令行工具：
  • 用1.5.6独立版执行./artemis export --file exported-messages.xml --directory /path/to/old/persistence
  • 用2.7.0独立版初始化空服务器后，执行./artemis import --file exported-messages.xml --directory /path/to/new/persistence

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