升级 .NET 10 不想等 Pomelo？试试 Microting.EntityFrameworkCore.MySql

本文将带你了解：想尽快升级 .NET 10 但 Pomelo 还没支持 EF Core 10 怎么办？Microting 是什么？如何平滑完成迁移？

一、背景：想升级 .NET 10，Pomelo 还没跟上怎么办？

1.1 .NET 10 LTS 已经到来

2025 年 11 月 11 日，微软在 .NET Conf 2025 大会上正式发布了 .NET 10。作为 LTS（长期支持）版本，.NET 10 将获得长达 3 年的官方支持，直至 2028 年 11 月。

对于希望尽早体验新特性、保持技术栈先进性的团队来说，升级到 .NET 10 有很多吸引力：

• 安全更新保障：3 年内持续接收安全补丁
• 性能提升：JIT 优化、硬件加速（AVX10.2、Arm64 SVE）、NativeAOT 改进等
• 新特性可用：C# 14、EF Core 10、ASP.NET Core 增强、AI 能力集成等
• 长期支持：LTS 版本提供更稳定的维护周期

1.2 MySQL EF Core 提供程序的版本节奏差异

对于使用 MySQL / MariaDB 作为数据库的 .NET 项目，Pomelo.EntityFrameworkCore.MySql 是最常用的 EF Core 提供程序。

Pomelo 是 .NET 生态中最主流的 EF Core MySQL 提供程序，微软官方文档也将其列为 MySQL / MariaDB 的推荐提供程序之一。截至 2026 年中，Pomelo 的 NuGet 总下载量已超过 1.26 亿次，日均下载约 7.6 万次，被近千个 NuGet 包和上百个 GitHub 开源项目依赖。

不过，Pomelo 的版本发布节奏与 .NET / EF Core 的官方发布节奏存在时间差。作为社区驱动的开源项目，Pomelo 由志愿者维护，版本更新需要一定时间。

以下是当前的版本支持现状：

简单来说：EF Core 10 已经发布半年多了，Pomelo 支持 EF Core 10 的稳定版本仍在开发中。

对于希望尽快升级到 .NET 10 的团队来说，如果不想等待 Pomelo 的官方更新，有没有其他选择呢？答案是有的——Microting.EntityFrameworkCore.MySql。

二、为什么是 Microting？

2.1 Microting 是什么？

Microting.EntityFrameworkCore.MySql 是 Pomelo.EntityFrameworkCore.MySql 的一个官方分支（fork），由丹麦公司 Microting A/S 维护。

在 NuGet 包的描述中，它明确说明了自己的定位：

"This is a fast moving version of Pomelo.EntityFrameworkCore.MySql intended to follow .net release cycle closely! There are no intentions for this package to implement new features."

（这是 Pomelo.EntityFrameworkCore.MySql 的快速迭代版本，旨在紧密跟随 .NET 发布周期！本包无意实现新功能。）

换句话说，Microting 的定位非常清晰：

• ✅ 紧跟 .NET 发布节奏：.NET 一出新版本，Microting 很快就会跟上
• ✅ 功能与 Pomelo 对齐：不添加新功能，保持与 Pomelo 的功能一致性
• ✅ API 高度兼容：作为直接分支，核心 API 基本不变
• ❌ 不做功能创新：新功能需求应提交给上游 Pomelo 项目

2.2 谁在维护 Microting？

Microting 背后是一家丹麦的技术公司 Microting A/S，其核心产品是 Microting eForm——一个用于数字化纸质表单、检查表、工单等的移动和 Web 应用。

那么，一家做电子表单的公司为什么要维护一个 EF Core MySQL 提供程序？

答案很简单：Microting 自己的产品深度依赖 EF Core + MySQL，他们需要紧跟 .NET 的发布节奏，而 Pomelo 的更新速度满足不了他们的需求。于是，他们 fork 了 Pomelo，创建了自己的快速跟进版本，并开源回馈给社区。

这种"自己用，也让大家用"的模式，反而让 Microting 拥有了稳定的维护动力——只要 Microting 公司还在使用 .NET + MySQL，这个包就会持续更新。

2.3 版本跟进速度对比

用数据说话，看看 Microting 的跟进速度：

注：.NET 9 时代 Microting 也有滞后，但从 .NET 10 开始跟进速度明显加快，已有多个 10.0.x 稳定版本发布。

而 Pomelo 呢？截至 2026 年 6 月，距离 .NET 10 发布已超过半年，Pomelo 的 EF Core 10 支持仍在开发中（GitHub 上有相关 Issue 跟踪，但尚无稳定版发布）。

2.4 谁在用 Microting？

虽然 Microting 的总下载量（约 28.6 万）远不及 Pomelo（1.26 亿），但已经有不少知名开源项目率先采用：

• Squidex（⭐ 2.5K+）- Headless CMS 平台
• Smartstore（⭐ 1.5K+）- 开源电商平台（已升级到 ASP.NET Core 10）
• IoTSharp（⭐ 1.3K+）- IoT 平台
• Virto Commerce（⭐ 1.3K+）- B2B 电商平台
• abp-next-admin（⭐ 1.0K+）- ABP vNext 前端管理项目

这些项目的采用，从侧面验证了 Microting 的可用性和稳定性。

三、Pomelo vs Microting：全面对比

在决定迁移之前，我们需要清楚地了解两者的异同。

3.1 功能与 API 兼容性

好消息是：Microting 是 Pomelo 的直接分支，核心功能和 API 高度兼容。 迁移的主要工作量是命名空间替换，而非代码重写。

一句话总结：改个命名空间，其他基本不用动。

3.2 版本支持矩阵

3.3 生态与社区对比

从生态规模来看，Pomelo 仍然占据绝对优势。但 Microting 的优势在于版本跟进速度——这正是当前升级 .NET 10 最需要的。

3.4 维护模式的差异

这是两者最本质的区别：

• Pomelo：社区驱动的开源项目，由志愿者维护，发布节奏取决于贡献者的时间和精力
• Microting：商业公司维护的开源项目，维护动力来自公司自身产品的需求，发布节奏与 .NET 官方对齐

两种模式各有优劣：社区驱动的项目生态更繁荣，但发布节奏可能不稳定；商业驱动的项目发布更有保障，但一旦公司战略调整，项目可能停止维护。

不过好消息是，由于两者 API 高度兼容，未来如果 Pomelo 恢复快速更新，迁回去的成本也很低。

四、迁移实操指南

说了这么多，现在来看看具体怎么迁移。由于 Microting 与 Pomelo API 高度兼容，整个迁移过程相对简单。

4.1 迁移前准备

在开始迁移之前，请确保：

1. ✅ 项目已备份：代码已提交到版本控制，数据库有备份
2. ✅ 明确目标版本：确定要升级到的 .NET 版本和 Microting 版本
3. ✅ 检查第三方依赖：确认项目中其他依赖 Pomelo 的第三方库是否有 Microting 兼容版本
4. ✅ 在独立分支上操作：创建专门的迁移分支，不影响主开发线

4.2 步骤一：替换 NuGet 包引用

首先，卸载所有 Pomelo 相关的 NuGet 包：

# 卸载主包
dotnet remove package Pomelo.EntityFrameworkCore.MySql

# 卸载扩展包（如果使用了的话）
dotnet remove package Pomelo.EntityFrameworkCore.MySql.Json.Microsoft
dotnet remove package Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft
dotnet remove package Pomelo.EntityFrameworkCore.MySql.NetTopologySuite
dotnet remove package Pomelo.EntityFrameworkCore.MySql.Design

然后，安装对应的 Microting 包：

# 安装主包
dotnet add package Microting.EntityFrameworkCore.MySql --version 10.0.9

# 按需安装扩展包（版本号与主包保持一致）
dotnet add package Microting.EntityFrameworkCore.MySql.Json.Microsoft --version 10.0.9
dotnet add package Microting.EntityFrameworkCore.MySql.Json.Newtonsoft --version 10.0.9
dotnet add package Microting.EntityFrameworkCore.MySql.NetTopologySuite --version 10.0.9

💡 提示：Microting 的扩展包命名规则与 Pomelo 完全一致，只是将 Pomelo 替换为 Microting。

4.3 步骤二：更新命名空间引用

在所有 C# 源文件中，将 Pomelo 命名空间替换为 Microting。

全局替换前：

using Pomelo.EntityFrameworkCore.MySql;
using Pomelo.EntityFrameworkCore.MySql.Infrastructure;
using Pomelo.EntityFrameworkCore.MySql.Storage;
using Pomelo.EntityFrameworkCore.MySql.Json.Microsoft;
// ... 其他 Pomelo 命名空间

全局替换后：

using Microting.EntityFrameworkCore.MySql;
using Microting.EntityFrameworkCore.MySql.Infrastructure;
using Microting.EntityFrameworkCore.MySql.Storage;
using Microting.EntityFrameworkCore.MySql.Json.Microsoft;
// ... 其他 Microting 命名空间

你可以使用 IDE 的全局替换功能（如 Visual Studio 的 Ctrl+Shift+H、VS Code 的 Ctrl+Shift+H），将 using Pomelo. 批量替换为 using Microting.。

⚠️ 注意：替换时请确认只替换 using 语句和类型引用中的 Pomelo，不要误替换注释、字符串等无关内容。

4.4 步骤三：验证 DbContext 配置

好消息是，DbContext 的配置代码基本不需要修改。UseMySql() 扩展方法的签名和用法完全一致。

// Program.cs 或 Startup.cs
services.AddDbContext<YourDbContext>(
    dbContextOptions => dbContextOptions
        .UseMySql(
            connectionString,
            serverVersion => serverVersion.ServerVersion(new MySqlServerVersion(new Version(8, 0, 30)))
        )
        .LogTo(Console.WriteLine, LogLevel.Information)
        .EnableSensitiveDataLogging()
        .EnableDetailedErrors()
);

MySqlServerVersion、MariaDbServerVersion 等类型的用法也完全相同。你只需要确保命名空间已经更新即可。

4.5 步骤四：处理迁移文件与快照

如果你的项目使用了 EF Core Migrations，需要检查迁移文件和快照文件。

4.5.1 检查迁移文件

打开 Migrations 目录下的迁移文件（*.cs），检查是否有硬编码的 Pomelo 命名空间引用：

• 迁移文件顶部的 using 语句 → 需要替换
• 迁移类中的属性、特性 → 通常不需要修改

4.5.2 检查模型快照

模型快照文件（*ModelSnapshot.cs）中可能包含提供程序特定的注解。检查其中是否有 Pomelo 相关的字符串引用。

4.5.3 生成新的迁移快照

建议在完成代码修改后，生成一个新的迁移来更新快照：

dotnet ef migrations add MigrateToMicroting

通常情况下，这个迁移不会产生实际的数据库变更（因为 Microting 与 Pomelo 的数据库行为一致），但会更新模型快照中的提供程序信息，确保后续迁移正常工作。

执行迁移：

dotnet ef database update

💡 提示：如果生成的迁移是空的（Up 和 Down 方法中没有操作），那是正常的——说明数据库结构不需要变化。

4.6 步骤五：全面测试验证

迁移完成后，务必进行全面的测试：

特别注意以下容易出问题的地方：

• 连接字符串：Microting 同样基于 MySqlConnector，连接字符串格式兼容，但建议确认高级选项（如 AllowUserVariables、UseAffectedRows 等）是否正常工作
• EF Core Tools：确保 dotnet ef 命令行工具版本与 EF Core 10 匹配
• 第三方库：检查依赖 Pomelo 的第三方库（如 EFCore.BulkExtensions.MySql）是否兼容 Microting

五、注意事项与风险提示

虽然迁移过程相对简单，但仍有一些需要注意的地方。

5.1 第三方库兼容性风险

这是迁移过程中最可能遇到的问题。

许多 EF Core 扩展库（如批量操作、审计日志、软删除等）可能直接依赖 Pomelo。如果这些库硬编码了对 Pomelo.EntityFrameworkCore.MySql 的引用，那么它们将无法与 Microting 一起使用。

应对策略：

1. 检查项目中每个依赖 Pomelo 的第三方库
2. 查看该库是否有支持 Microting 的版本或替代方案
3. 如果没有，考虑是否可以移除该依赖，或自行 fork 适配

5.2 连接字符串与底层驱动

Microting 10.x 要求 MySqlConnector >= 2.6.0，而 Pomelo 9.0 要求的是 MySqlConnector >= 2.4.0。

虽然 MySqlConnector 是向后兼容的，但版本升级可能带来一些细微的行为变化。建议：

• 查阅 MySqlConnector 的版本发布说明，了解 2.4 到 2.6 之间的变化
• 特别关注连接字符串参数的默认值变化
• 测试与连接管理相关的功能（连接池、超时、SSL 等）

5.3 回滚方案

迁移不是单向的。如果在测试中发现严重问题，你需要有回滚的能力：

1. 代码回滚：由于迁移操作主要是命名空间替换和包引用更改，回滚同样简单——反向操作即可
2. 数据库回滚：确保迁移前有数据库备份，避免迁移导致的数据问题
3. 版本分支：在独立的 Git 分支上进行迁移，方便随时切换回 Pomelo 版本

5.4 长期维护考量

选择 Microting 意味着选择了一种不同的维护模式。以下是一些需要考虑的长期因素：

Microting 的优势：

• 发布节奏快，紧跟 .NET 版本
• 商业公司维护，有稳定的维护动力
• MIT 协议，与 Pomelo 相同

Microting 的潜在风险：

• 生态规模较小，遇到问题时可参考的资料较少
• 维护主体是单一公司，如果公司战略调整，项目可能停止维护
• 不添加新功能，如果需要新的 MySQL / EF Core 特性，仍需等待 Pomelo 实现后 Microting 跟进

建议：将 Microting 视为一个过渡方案或并行选项。如果未来 Pomelo 恢复了快速的版本更新，你可以根据实际情况选择继续使用 Microting 或迁回 Pomelo——由于 API 高度兼容，迁移成本很低。

5.5 生产环境部署建议

对于生产环境的升级，建议采取谨慎策略：

1. 先在测试环境充分验证：至少运行 1 ~ 2 周的测试环境验证
2. 灰度发布：先部署到少量实例，观察运行情况
3. 监控关键指标：数据库连接数、查询性能、错误率等
4. 制定回滚预案：确保出现问题时可以快速回滚

六、总结与建议

6.1 哪些团队适合选择 Microting？

如果你符合以下大部分情况，那么从 Pomelo 切换到 Microting 是一个值得考虑的选择：

• ✅ 希望尽快升级到 .NET 10 LTS，不想等待 Pomelo 的更新
• ✅ 使用 MySQL / MariaDB 作为主数据库
• ✅ 项目升级计划不希望因提供程序版本而推迟
• ✅ 项目中没有深度依赖 Pomelo 特有功能的第三方库
• ✅ 团队能够接受从社区驱动转向商业公司维护的提供程序

6.2 哪些情况可以继续使用 Pomelo？

如果你符合以下情况，可以继续使用 Pomelo，等待其官方支持 EF Core 10：

• ⏸️ 项目仍在 .NET 8 / EF Core 8 上运行良好，暂无升级计划
• ⏸️ 对稳定性和成熟度要求极高，希望继续使用经过更广泛验证的方案
• ⏸️ 深度依赖大量基于 Pomelo 的第三方库
• ⏸️ 时间充裕，可以等待 Pomelo 官方支持 EF Core 10 后再升级

6.3 迁移复杂度评估

好消息是：这次迁移的复杂度相当低。

总体而言，这是一次低风险、低成本的迁移。最大的不确定因素是第三方库的兼容性，而这取决于你的具体项目情况。

6.4 写在最后

Pomelo 作为 .NET 生态中最主流的 MySQL EF Core 提供程序，为社区做出了巨大贡献。作为社区驱动的开源项目，Pomelo 由志愿者维护，版本发布节奏相对稳健。Microting 的出现，为开发者提供了另一种选择——它专注于快速跟进 .NET 版本，让希望尽早升级的团队能够及时用上新版本。

对于希望尽早升级到 .NET 10 的团队来说，Microting 提供了一条低门槛的路径。而 API 的高度兼容性，意味着你随时可以根据情况选择继续使用 Microting、迁回 Pomelo，甚至在两者之间灵活切换。

技术选型从来不是非此即彼的单选题。了解每个选项的特点，根据自身情况做出最合适的选择，才是最重要的。

参考资料：

• Microsoft .NET Blog - Announcing .NET 10
• NuGet - Pomelo.EntityFrameworkCore.MySql
• NuGet - Microting.EntityFrameworkCore.MySql
• Microsoft Learn - EF Core 10 新增功能
• Microting 官网
• GitHub - PomeloFoundation/Pomelo.EntityFrameworkCore.MySql
• GitHub - microting/Microting.EntityFrameworkCore.MySql