dapper-dot-net与Entity Framework Core共存：混合ORM架构设计

dapper-dot-net与Entity Framework Core共存：混合ORM架构设计

【免费下载链接】Dapper 项目地址: https://gitcode.com/gh_mirrors/dappe/dapper-dot-net

在现代应用开发中，数据访问层的设计往往面临两难选择：追求开发效率还是运行性能？实体框架（Entity Framework Core，简称EF Core）作为.NET生态中主流的对象关系映射（ORM）工具，提供了强大的LINQ查询和变更跟踪能力，但在高并发场景下可能面临性能瓶颈。而Dapper作为轻量级ORM（Micro-ORM），以接近原生SQL的执行效率著称，但缺乏EF Core的对象关系管理能力。本文将介绍如何在同一项目中混合使用这两种ORM，结合各自优势构建高效的数据访问层。

架构设计：为什么选择混合ORM

混合ORM架构的核心思想是根据业务场景选择合适的工具：

• EF Core：适用于复杂业务逻辑、多表关联查询及需要变更跟踪的场景
• Dapper：适用于高性能读写操作、报表生成及批量数据处理

项目中已包含专门的Dapper.EntityFramework扩展模块，通过类型处理器实现了EF Core空间数据类型（如DbGeography、DbGeometry）与Dapper的兼容，为混合架构提供了基础支持。相关实现可参考Dapper.EntityFramework/Handlers.cs。

环境配置与依赖管理

项目结构与引用关系

混合架构需要在项目中正确配置两者的依赖关系。核心项目文件结构如下：

dapper-dot-net/
├── Dapper/                  # Dapper核心库
├── Dapper.EntityFramework/  # EF Core兼容性扩展
└── benchmarks/
    └── EntityFrameworkCore/ # EF Core性能测试模块

通过分析Dapper.EntityFramework/Dapper.EntityFramework.csproj可知，该项目通过ProjectReference同时引用Dapper核心库和EntityFramework包，实现了类型系统的桥接。

必要的NuGet包

包名	用途
Dapper	核心Micro-ORM功能
Dapper.EntityFramework	EF类型兼容性支持
Microsoft.EntityFrameworkCore	EF Core核心功能

实现原理：类型系统桥接

Dapper.EntityFramework模块通过自定义类型处理器实现了EF Core特有类型与数据库的转换。以DbGeography类型为例，DbGeographyHandler.cs实现了两个关键方法：

// 写入数据库时的类型转换
public override void SetValue(IDbDataParameter parameter, DbGeography? value)
{
    object? parsed = null;
    if (value is not null)
    {
        parsed = SqlGeography.STGeomFromWKB(
            new SqlBytes(value.AsBinary()), 
            value.CoordinateSystemId);
    }
    parameter.Value = parsed ?? DBNull.Value;
    if (parameter is SqlParameter sqlParameter)
    {
        sqlParameter.UdtTypeName = "geography";
    }
}

// 从数据库读取时的类型转换
public override DbGeography? Parse(object? value)
{
    if (value is null || value is DBNull) return null;
    if (value is SqlGeography geo)
    {
        return DbGeography.FromBinary(
            geo.STAsBinary().Value, 
            geo.STSrid.Value);
    }
    return DbGeography.FromText(value.ToString());
}

在使用前需通过Handlers.Register()方法注册这些类型处理器，测试代码示例可参考tests/Dapper.Tests/Providers/EntityFrameworkTests.cs中的测试初始化：

public EntityFrameworkTests()
{
    EntityFramework.Handlers.Register();
}

实战案例：混合使用场景

场景1：EF Core管理实体关系 + Dapper优化查询

假设我们有一个博客系统，使用EF Core定义实体关系：

// 定义于benchmarks/EntityFrameworkCore/EFCoreContext.cs
public class EFCoreContext : DbContext
{
    public DbSet<Post> Posts { get; set; }
    
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
        => optionsBuilder.UseSqlServer(_connectionString);
}

对于简单的单表查询，可使用Dapper提升性能：

// 使用Dapper查询单篇文章
var post = connection.QuerySingle<Post>(
    "SELECT * FROM Posts WHERE Id = @Id", 
    new { Id = postId });

场景2：事务一致性保证

通过共享数据库连接，可在同一事务中混合使用两种ORM：

using (var transaction = connection.BeginTransaction())
{
    try
    {
        // 使用EF Core更新实体
        var blog = context.Blogs.Find(blogId);
        blog.Name = "Updated Name";
        context.SaveChanges();
        
        // 使用Dapper批量插入评论
        connection.Execute(
            "INSERT INTO Comments (PostId, Content) VALUES (@PostId, @Content)",
            comments,
            transaction: transaction);
            
        transaction.Commit();
    }
    catch
    {
        transaction.Rollback();
        throw;
    }
}

场景3：空间数据处理

项目中已实现对EF Core空间数据类型的支持，可直接在Dapper中使用：

// 插入空间数据
var location = DbGeography.PointFromText("POINT(-122.1215 47.6740)", 4326);
connection.Execute(
    "INSERT INTO Locations (Name, GeoLocation) VALUES (@Name, @GeoLocation)",
    new { Name = "Redmond", GeoLocation = location });

// 查询空间数据
var locations = connection.Query<Location>(
    "SELECT * FROM Locations WHERE GeoLocation.STDistance(@Point) < 1000",
    new { Point = targetLocation });

性能对比与适用场景

根据项目基准测试数据（benchmarks/Dapper.Tests.Performance/Benchmarks.EntityFrameworkCore.cs），在简单查询场景下Dapper性能约为EF Core的2-3倍：

ORM	平均执行时间	内存分配
Dapper	133.73 us	11608 B
EF Core (First)	317.12 us	11306 B
EF Core (Compiled)	265.45 us	7521 B

决策指南：如何选择合适的ORM

• 优先使用Dapper：

  • 简单CRUD操作
  • 报表查询
  • 批量数据操作
  • 性能关键路径

• 优先使用EF Core：

  • 复杂业务实体关系
  • 需要变更跟踪的场景
  • 快速开发迭代
  • 团队更熟悉LINQ语法

最佳实践与注意事项

连接管理

确保两种ORM共享同一数据库连接以保证事务一致性：

// 从EF Core获取连接并交给Dapper使用
var connection = context.Database.GetDbConnection();
connection.Open();
// 使用Dapper查询
var result = connection.Query<Stats>("SELECT * FROM Statistics");

避免重复映射

为避免实体类重复定义，可使用部分类分离两种ORM的特性：

// 核心实体定义
public partial class Post
{
    public int Id { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
}

// EF Core特有配置
[EntityTypeConfiguration(typeof(PostConfiguration))]
public partial class Post { }

测试策略

项目测试模块提供了完整的混合使用测试案例，可参考tests/Dapper.Tests/Providers/EntityFrameworkTests.cs中的测试方法，如：

[Fact]
public void Issue570_DbGeo_HasValues()
{
    // 测试Dapper与EF Core空间类型兼容性
    var fromDb = connection.QuerySingle<DbGeography>(
        "DECLARE @geos table(geo geography); " +
        "INSERT @geos(geo) values(@val); " +
        "SELECT * from @geos",
        new { val = orig });
    
    Assert.Equal(orig.Area, fromDb.Area);
}

总结与展望

混合ORM架构通过扬长避短，充分发挥了Dapper的性能优势和EF Core的开发效率。项目中Dapper.EntityFramework模块提供的类型处理器实现了两者的无缝集成，为复杂业务场景提供了灵活的数据访问方案。

官方文档：Readme.md
性能测试源码：benchmarks/Dapper.Tests.Performance/
EF兼容性模块：Dapper.EntityFramework/

未来随着项目的发展，可进一步优化两种ORM的集成度，例如实现基于表达式树的查询转换、统一的事务管理接口等，为混合架构提供更完善的支持。

提示：实际项目中应根据具体业务场景选择合适的ORM，避免盲目追求性能而牺牲开发效率，或为快速开发而忽视性能瓶颈。

欢迎点赞收藏本文，关注后续《混合ORM架构的单元测试策略》系列文章。

【免费下载链接】Dapper 项目地址: https://gitcode.com/gh_mirrors/dappe/dapper-dot-net