Dapper 不负责连接数据库，而是依赖 ADO.NET 的 IDbConnection（如 SqlConnection）执行 SQL；连接字符串需按数据库类型正确配置，并通过 using 管理连接生命周期，推荐用 appsettings.json 和 IConfiguration 安全管理。
Dapper 本身不负责连接数据库，它只是轻量级的 ORM 工具，依赖 ADO.NET 的 IDbConnection（比如 SqlConnection、MySqlConnection 等）来执行 SQL。所以“Dapper 连接数据库”的本质，是用 Dapper 调用已配置好的数据库连接对象。
连接字符串怎么写？常见数据库示例
连接字符串是告诉程序“去哪连、用谁连、怎么认证”的关键文本。不同数据库格式不同，但核心字段类似：
-
SQL Server（Windows 认证）：
"Server=localhost\\SQLEXPRESS;Database=MyAppDB;Trusted_Connection=true;" -
SQL Server（用户名密码）：
"Server=localhost;Database=MyAppDB;User Id=myuser;Password=mypass;" -
MySQL（需安装 MySqlConnector 或 Pomelo.EntityFrameworkCore.MySql）：
"Server=localhost;Port=3306;Database=myapp;Uid=root;Pwd=123456;" -
PostgreSQL（需 Npgsql）：
"Host=localhost;Port=5432;Database=myapp;Username=postgres;Password=123456;"
在代码里怎么用连接字符串创建连接
别直接 new SqlConnection("xxx") 写死——推荐用 using 确保及时释放，再传给 Dapper 方法：
string connectionString = "Server=localhost;Database=MyAppDB;User Id=sa;Password=123456;"; using var conn = new SqlConnection(connectionString); conn.Open();var users = conn.Query
("SELECT * FROM Users WHERE Age > @age", new { age = 18 });
注意：Dapper 所有扩展方法（Query、Execute、QuerySingle 等）都定义在 IDbConnection 上，只要传入合法打开的连接即可。
怎么安全又方便地管理连接字符串
硬编码或写在代码里既不安全也不易维护。推荐方式：
-
.NET Core / .NET 5+ 项目： 放在
appsettings.json中，通过IConfiguration读取 -
ASP.NET Core 启动时注册连接工厂： 用
AddScoped或封装一个(...) IDbConnectionFactory -
敏感信息（如密码）： 开发用
User Secrets，生产用 Azure Key Vault、环境变量或配置中心
常见报错和检查点
连不上？先快速核对这几项：
- 连接字符串里的服务器名、端口、数据库名是否拼写正确（大小写一般不敏感，但实例名如
SQLEXPRESS要准确） - 数据库服务是否正在运行（SQL Server Management Studio 能连上吗？）
- 防火墙是否放行了数据库端口（如 SQL Server 默认 1433）
- 用户是否有对应数据库的访问权限（特别是新建登录后没映射数据库用户）
- 项目是否引用了正确的数据库驱动（
System.Data.SqlClient已过时，.NET Core 推荐Microsoft.Data.SqlClient）
基本上就这些。Dapper 配置连接不是它自己的事，而是你把 ADO.NET 连接准备好，它才开始干活——越理解底层连接逻辑，越不容易卡在“连不上”这一步。
