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();
<p>var users = conn.Query<User>("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<idbconnection sqlconnection>(...)</idbconnection>或封装一个
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 连接准备好，它才开始干活——越理解底层连接逻辑，越不容易卡在“连不上”这一步。
