Advises on migrating data acce…

# ADO.NET 迁移 Dapper 分阶段方案与连接管理改造

一、前期准备阶段（1-2周）

• 统一 NuGet 依赖：新建内部共享类库（如 Company.Data），统一引用 Dapper 主包及 Microsoft.Data.SqlClient（替代老旧的 System.Data.SqlClient）
• 摸底盘点：扫描 20 个项目中所有 SqlConnection/SqlCommand/SqlDataAdapter 的使用点，按“CRUD 简单查询、存储过程、事务、大数据量批处理”分类，标记高风险点
• 建立基线：为核心接口补充集成测试，用真实测试库回归，防止迁移后行为变化

二、分阶段迁移（按项目风险递进）

阶段1：试点（选1-2个低风险项目）

• 简单查询改为 connection.Query<T>(sql, param)，参数化 SQL 替代拼接 SQL（防注入）
• 保持原项目结构，改动最小化，跑通迁移流程

阶段2：模式固化

• 总结试点经验，制定团队规范：
• SQL 统一放 Repository 层或用常量/Dapper.Contrib
• 强制参数化，新增 DynamicParameters 用法示例
• 存储过程用 commandType: CommandType.StoredProcedure
• 编写通用封装：分页查询、多结果集 QueryMultiple、批量插入

阶段3：批量推广（3-5个项目/批）

• 复杂事务场景用显式事务包装：

```csharp

using var conn = connectionFactory.Create();

conn.Open();

using var tran = conn.BeginTransaction();

// 多个 Execute/Query 共享 tran

tran.Commit();

```

• 遗留 DataSet/DataTable 逐步改为强类型 POCO + Query<T>

阶段4：收尾

• 全量回归测试、性能对比（响应时间、连接池命中率）
• 删除残留 ADO.NET 直连代码，加架构约束（如 Roslyn 分析器禁止 new SqlConnection）

三、连接管理改造建议

• 废弃手写单例连接：ADO.NET 时代常自建连接缓存类，必须移除。SQL Server 连接应“短连接+连接池”，open→操作→dispose
• 统一工厂模式：实现 ISqlConnectionFactory，封装连接字符串（来自 IConfiguration），返回 DbConnection
• 注入方式：ASP.NET Core 中注册 AddScoped<ISqlConnectionFactory>，或直接 AddScoped<IDbConnection>（注意 scoped 连接不自动 open）
• 连接字符串规范：统一迁到 appsettings/配置中心，开启 Pooling=true，按环境区分；敏感信息用 Secret Manager/Key Vault
• 异步化：迁移时顺手改为 QueryAsync/ExecuteAsync，全链路 async/await

四、风险提示

• 分批上线，每批保留回滚分支
• CommandTimeout、TransactionScope（分布式事务在 .NET Core 下需 Windows 环境）重点验证