FreeSql 动态连接管理与读写分离实践指南

动态连接管理需求背景

在现代应用开发中，数据库连接管理是一个关键环节。FreeSql 作为一款功能强大的 ORM 框架，提供了多种连接管理方式。在实际业务场景中，开发者经常面临以下需求：

1. 运行时动态修改数据库连接字符串
2. 实现读写分离架构
3. 根据不同操作类型（查询/写入）自动选择数据源

传统解决方案的局限性

FreeSql 提供了 UseConnectionFactory 方法，允许开发者自定义连接创建逻辑。然而，这种方法存在以下限制：

• 无法感知当前操作是读操作还是写操作
• 难以在运行时动态切换主从库
• 缺乏对 SQL 类型的识别能力

FreeSql 提供的解决方案

方案一：连接池与从库配置

使用 UseAdoConnectionPool 结合 UseSlave 方法可以实现基础的读写分离：

var fsql = new FreeSqlBuilder()
    .UseAdoConnectionPool(true)
    .UseConnectionString(DataType.SqlServer, "主库连接字符串")
    .UseSlave("从库1连接字符串", "从库2连接字符串")
    .Build();

优点：

• 配置简单
• 自动负载均衡读请求

缺点：

• 运行时无法动态修改连接字符串
• 需要重建 FreeSql 实例才能更新配置

方案二：FreeSqlCloud 动态路由

FreeSqlCloud 提供了更灵活的数据库路由能力，可以基于实体类型或操作类型进行动态路由：

public enum DbEnum { Master, ReadReplica1, ReadReplica2 }

var fsql = new FreeSqlCloud();

// 注册多个数据库配置
fsql.Register(DbEnum.Master, () => new FreeSqlBuilder()
    .UseConnectionString(DataType.SqlServer, "主库连接字符串")
    .Build());

fsql.Register(DbEnum.ReadReplica1, () => new FreeSqlBuilder()
    .UseConnectionString(DataType.SqlServer, "从库1连接字符串")
    .Build());

// 配置实体路由规则
fsql.EntitySteering = (_, e) =>
{
    // 按实体类型路由
    if (e.EntityType == typeof(User)) e.DBKey = DbEnum.ReadReplica1;
    
    // 或者按操作类型实现读写分离
    if (e.MethodName == "Select" && e.DBKey == DbEnum.Master)
    {
        var replicas = new[] { DbEnum.ReadReplica1, DbEnum.ReadReplica2 };
        e.DBKey = replicas[new Random().Next(0, replicas.Length)];
    }
};

核心功能：

1. 多数据库实例注册与管理
2. 基于实体类型的自动路由
3. 基于操作类型的动态切换
4. 显式上下文切换能力

高级用法：

// 显式切换上下文
using (fsql.Change(DbEnum.Master))
{
    // 此代码块内所有操作使用主库
    fsql.Insert(new User()).ExecuteAffrows();
}

技术实现原理

FreeSqlCloud 的核心设计思想是：

1. 多租户隔离：每个数据库实例独立管理连接池和配置
2. 动态代理：在执行操作前拦截并路由到正确的数据库实例
3. 上下文管理：通过 IDisposable 模式实现作用域内的数据库切换

最佳实践建议

1. 连接管理：

   • 主库连接池大小应适当大于从库
   • 长时间运行的应用应监控连接泄漏

2. 读写分离：

   • 重要业务操作可强制使用主库
   • 报表类查询优先路由到专用分析实例

3. 异常处理：

   • 实现从库故障自动降级到主库
   • 考虑主从同步延迟对业务的影响

性能考量

1. 连接池配置应根据实际并发量调整
2. 频繁的上下文切换会带来性能开销
3. 复杂路由逻辑可能增加请求延迟

总结

FreeSql 通过 FreeSqlCloud 提供了强大的动态数据库路由能力，能够满足各种复杂场景下的连接管理需求。开发者可以根据业务特点选择合适的实现方案，平衡灵活性、性能和维护成本。对于需要精细控制数据库访问的场景，FreeSqlCloud 的实体路由和操作拦截机制提供了极大的便利。