Dapper本身不管理连接字符串，其连接字符串即数据库连接字符串，统一配置在appsettings.json的ConnectionStrings节中，通过IConfiguration注入或注册IDbConnection工厂使用，推荐每次查询创建新连接。
ASP.NET Core 中 Dapper 本身不管理连接字符串，它只是一个轻量级的 ORM 工具，依赖 IDbConnection（如 SqlConnection）来执行 SQL。所以“Dapper 的连接字符串”实际就是你数据库的连接字符串，配置位置和方式与 ASP.NET Core 的标准数据库配置完全一致——统一在 appsettings.json 中定义，再通过 IConfiguration 注入或读取。
1. 在 appsettings.json 中配置连接字符串
这是最常用、推荐的方式。在项目根目录的 appsettings.json 文件中添加：
{
"ConnectionStrings": {
"DefaultConnection": "Server=localhost;Database=MyAppDb;Trusted_Connection=true;MultipleActiveResultSets=true;"
}
}注意：ConnectionStrings 是约定名称，可自定义，但需与后续读取代码保持一致。
2. 在 Program.cs（或 Startup.cs）中注册服务（可选）
如果你希望把连接字符串封装为一个可注入的服务（比如提供 SqlConnection 实例），可以在 Program.cs 中这样写：
- 直接读取并注册为单例（适合简单场景）：
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddSingleton(connectionString); - 更推荐：注册
SqlConnection工厂（避免连接复用问题）：
builder.Services.AddTransient(sp => { var conn = new SqlConnection(connectionString); conn.Open(); // 可选：按需打开，通常建议在使用时再 Open return conn; });
⚠️ 注意：不建议将 SqlConnection 注册为 Singleton，因为连接对象不是线程安全的，且可能被意外关闭或超时。
3. 在 Repository 或 Service 中使用连接字符串
实际使用 Dapper 时，一般在仓储类中通过构造函数注入 IConfiguration 或已注册的连接工厂：
- 方式一：注入
IConfiguration，按需创建连接（最灵活）：
public class ProductRepository
{
private readonly IConfiguration _config;
public ProductRepository(IConfiguration config) => _config = config;
public async Task> GetAll()
{
var connStr = _config.GetConnectionString("DefaultConnection");
using var conn = new SqlConnection(connStr);
return await conn.QueryAsync("SELECT * FROM Products");
}
}
- 方式二：注入
IDbConnection（前提是已注册为Transient）：
public class ProductRepository
{
private readonly IDbConnection _conn;
public ProductRepository(IDbConnection conn) => _conn = conn;
public async Task> GetAll() =>
await _conn.QueryAsync("SELECT * FROM Products");
}
✅ 推荐方式一，因为它确保每次查询都使用新连接，符合 Dapper “轻量、显式、控制权在开发者手中”的设计哲学。
4. 环境适配（开发/生产）
连接字符串可按环境区分，例如：
-
appsettings.Development.json使用本地 SQL Server Express 或 LocalDB -
appsettings.Production.json使用 Azure SQL 或正式服务器地址
ASP.NET Core 会自动合并配置，优先级：环境配置 > 基础配置。
基本上就这些。Dapper 没有专属配置项，关键就是把连接字符串放对地方、用对方式——别把它当框架配，而要当数据库凭据管。
