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

来源：这里教程网时间：2026-02-21 17:34:01 作者：

用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<User>("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比本地还稳——毕竟它的设计就是为这种高并发、低延迟场景准备的。