Dapper如何连接Azure SQL数据库 Dapper连接Azure SQL配置

Dapper连接Azure SQL需正确配置连接字符串并规范使用SqlConnection：启用Encrypt=True、TrustServerCertificate=False、MultipleActiveResultSets=True、Connection Timeout=30等参数，代码中通过IConfiguration读取连接字符串，用using确保释放，调用Open()后执行Query/Execute。

用Dapper连接Azure SQL数据库，核心是两件事：配对的连接字符串 + 正确的 SqlConnection 使用方式。它本身不管理连接，但能高效复用 ADO.NET 的连接池机制，所以配置得当，就能稳定跑在云上。

Azure SQL专用连接字符串写法

必须启用加密、设置超时、打开MARS（多活动结果集），否则容易在云环境中出错或超时：

• Server=tcp:yourserver.database.windows.net,1433
• Initial Catalog=yourdatabase
• User ID=youradmin@yourserver（注意：Azure SQL要求带服务器名的完整用户名）
• Password=yourstrongpassword
• Encrypt=True（强制TLS加密，Azure强制要求）
• TrustServerCertificate=False（禁用自签名证书信任，更安全）
• Multip‌leActiveResultSets=True（支持Dapper中多次Query/Execute混用）
• Connection Timeout=30（建议20–30秒，兼顾重试与响应）
• ConnectRetryCount=3 和 ConnectRetryInterval=10（可选，应对临时网络抖动）

代码中加载与使用连接

推荐从配置文件读取，避免硬编码。比如在 appsettings.json 中定义：

"ConnectionStrings": {
  "AzureSql": "Server=tcp:xxx.database.windows.net,1433;..."
}

然后在服务注册或数据访问层中这样用：

• 通过 IConfiguration 获取连接字符串（.NET 6+ 推荐）
• 用 new SqlConnection(connectionString) 创建连接对象
• 务必用 using 确保释放（Dapper不接管生命周期）
• 执行前调用 connection.Open()（Dapper不自动打开）

示例：

using var conn = new SqlConnection(config.GetConnectionString("AzureSql"));
conn.Open();
var users = conn.Query("SELECT * FROM Users WHERE Active = 1");

关键参数与运行时优化

Dapper本身轻量，但云环境要主动控制行为：

• commandTimeout：高频查询建议设为 5–10 秒，防止拖垮连接池；批量操作可放宽到 30–60 秒
• Buffered 参数：默认 Buffered=true，适合中小结果集；查百万行用 flags: CommandFlags.None 流式读取
• 参数化必须：所有用户输入都走 @param 占位符，既防注入，也提升 Azure SQL 查询计划复用率
• 避免长连接闲置：云数据库连接池资源有限，不要缓存 SqlConnection 实例，让 .NET 自动复用

部署时注意权限与网络

不是代码问题，但常卡在这儿：

• Azure SQL 防火墙必须放行应用所在IP（或开启“允许 Azure 服务和资源访问此服务器”）
• 若部署在 App Service，需在“网络”设置中启用“虚拟网络集成”或确认出站IP已加入白名单
• 使用托管标识（Managed Identity）代替密码更安全，需配合 Azure AD 认证连接字符串（如 Authentication=Active Directory Managed Identity）

基本上就这些。配置对了，Dapper连Azure SQL比本地还稳——毕竟它的设计就是为这种高并发、低延迟场景准备的。