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(禁用自签名证书信任,更安全)
- MultipleActiveResultSets=True(支持Dapper中多次Query/Execute混用)
- Connection Timeout=30(建议20–30秒,兼顾重试与响应)
- ConnectRetryCount=3 和 ConnectRetryInterval=10(可选,应对临时网络抖动)
代码中加载与使用连接
推荐从配置文件读取,避免硬编码。比如在 red">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比本地还稳——毕竟它的设计就是为这种高并发、低延迟场景准备的。










