Scala从2.10.0升级至2.13.10，eligosource-eventsourced替代方案咨询

一、替代库推荐 #

eligosource-eventsourced早已停止维护（最后更新可追溯至2014年），推荐以下适配Scala 2.13和Akka生态的成熟事件溯源/持久化库：

• Akka Persistence：Akka官方原生事件溯源组件，与Akka生态深度集成，支持JDBC、Cassandra、LevelDB等多种持久化后端，完全兼容Scala 2.13。迁移成本低，官方文档和社区支持完善，是首选替代方案。
• Eventuate：基于Akka的分布式事件溯源库，支持CQRS模式，维护状态良好，兼容Scala 2.12+，适合需要分布式事件一致性的场景。
• Lagom：Lightbend推出的微服务框架，内置事件溯源和CQRS能力，基于Akka和Play构建，完全支持Scala 2.13，适合微服务架构的项目。

二、继续使用eligosource-eventsourced的临时方案（不推荐长期使用） #

如果必须保留该库，可尝试以下路径，但需承担较高兼容性风险：

• 源码重编译适配：获取eligosource-eventsourced的源码，在Scala 2.13环境下重新编译。需处理Scala版本间的语法差异（如隐式转换写法、集合API变更），同时适配对应版本的Akka（原库依赖Akka 2.3.x，Scala 2.13对应Akka 2.6.x+，需大量修改依赖适配代码）。
• Shaded依赖打包：将eligosource-eventsourced及其依赖的Scala 2.10、Akka 2.3.x相关类打包为独立的shaded jar，通过类隔离避免与项目中Scala 2.13的类冲突。

三、OSGI环境下的适配方案 #

1. 替代库的OSGI兼容处理 #

选择Akka Persistence这类官方库时，Lightbend提供了OSGI兼容的bundle包，可直接部署到OSGI容器。只需确保引入的Akka Persistence bundle版本与Scala 2.13、Akka 2.6.x匹配，同时在MANIFEST.MF中正确配置依赖声明：

Import-Package: akka.persistence.*, scala.collection.*;version="[2.13,2.14)"
Export-Package: your.project.persistence.*

2. 保留原库的OSGI类隔离方案 #

若坚持使用eligosource-eventsourced，可通过嵌套bundle实现类隔离：
在自定义bundle的MANIFEST.MF中配置：

Bundle-ClassPath: ., lib/eligosource-eventsourced.jar, lib/scala-library-2.10.2.jar, lib/akka-actor-2.3.x.jar
Private-Package: scala.*, akka.actor.*, org.eligosource.eventsourced.*
Import-Package: !scala.*, !akka.actor.*, *

通过Private-Package隔离旧版本Scala和Akka的类，避免与容器中的新版本冲突；Import-Package排除旧版本依赖，仅导入项目所需的其他公共包。

总结 #

优先建议迁移到Akka Persistence这类官方维护的库，长期来看更稳定，且适配Scala新版本和OSGI环境。若必须保留原库，源码重编译或shaded类隔离是可行路径，但投入成本较高，且存在潜在兼容性问题。

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