Akka.NET 持久化插件迁移指南：从Sql.Common到新SQL插件

背景介绍

Akka.NET团队近期宣布了一项重要架构调整：正式弃用Akka.Persistence.Sql.Common及其相关插件。这一决定标志着Akka.NET持久化层的一个重要演进节点，旨在为开发者提供更统一、更高效的SQL持久化解决方案。

弃用范围详解

本次变更涉及多个核心插件，主要包括：

1. 基础库弃用
   Akka.Persistence.Sql.Common作为旧版SQL持久化的基础库将被全面淘汰，其查询组件Akka.Persistence.Query.Sql也同步弃用。

2. 数据库插件迁移
   三大主流数据库插件及其Hosting包都将停止维护：

   • SQL Server插件套件
   • PostgreSQL插件套件
   • MySQL插件套件

3. 代码库归档
   上述插件的GitHub仓库将被归档，转为只读状态，不再接受新的功能提交。

技术迁移方案

团队已提供完善的迁移路径，开发者应转向使用新的统一SQL持久化插件。该新插件采用Linq2Db作为数据访问层，相比旧方案具有以下优势：

• 更简洁的API设计
• 更好的性能表现
• 更统一的配置方式
• 更活跃的维护状态

特殊处理案例

值得注意的是，SQLite插件将获得特殊对待。考虑到Linq2Db在嵌入式环境和移动平台上的适用性问题，团队决定保留SQLite插件的现有实现。技术方案包括：

• 内联化必要的Sql.Common组件
• 保持轻量级特性
• 继续支持移动开发场景

迁移时间节点

这一架构调整将在Akka.NET v1.6正式版发布前完成全部过渡工作。开发者可以参照团队提供的迁移指南视频，按步骤完成现有项目的升级改造。

后续影响评估

此次变更虽然涉及面广，但通过提供清晰的迁移路径和详细的文档支持，团队力求将对现有项目的影响降到最低。建议所有使用相关插件的项目尽快规划迁移工作，以获得更好的性能和维护性保障。

对于Oracle数据库用户，相关插件的处理方案也将很快明确，建议关注官方更新公告。