EF Core配置连接字符串需确保三要素:写对格式(区分MySQL/SQL Server)、放对位置(appsettings.json中ConnectionStrings节)、用对方式(通过IConfiguration读取并注册DbContext);敏感信息禁硬编码,须验证连通性。

EF Core 配置连接字符串的核心就三件事:写对字符串、放对位置、用对方式。MySQL 和 SQL Server 写法不同,但配置逻辑一致,关键不是硬背格式,而是理解“谁读取它”和“谁使用它”。
连接字符串写法要匹配数据库类型
不能混用 SQL Server 和 MySQL 的格式,否则直接报错:
-
SQL Server 示例:
Server=localhost;Database=MyAppDb;User Id=sa;Password=123456;(Windows 认证可改用Trusted_Connection=true;) -
MySQL 示例(Pomelo):
server=localhost;port=3306;database=myappdb;user=root;password=123456; - 敏感信息如密码建议用环境变量或 Azure Key Vault 管理,不要硬编码在代码里
连接字符串必须放在配置源中,推荐 appsettings.json
ASP.NET Core 默认从 appsettings.json 读取,结构清晰且支持多环境切换:
{
"ConnectionStrings": {
"DefaultConnection": "server=localhost;port=3306;database=myappdb;user=root;password=123456;"
}
}
- 键名(如
DefaultConnection)要和后续代码中GetConnectionString("...")保持一致 - 开发环境可用
appsettings.Development.json单独覆盖,生产环境走环境变量更安全
DbContext 注册时要用 IConfiguration 读取,别手写字符串
在 Program.cs(.NET 6+)中注册 DbContext,靠 builder.Configuration 拿连接串:
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddDbContext(options =>
options.UseMySql(connectionString, ServerVersion.AutoDetect(connectionString)));
- 如果是 SQL Server,把
UseMySql(...)换成UseSqlServer(...) - MySQL 必须加
ServerVersion.AutoDetect(...)或明确指定版本,比如ServerVersion.Parse("8.0.33-mysql") - 不推荐在
OnConfiguring中硬写连接字符串,会破坏依赖注入和测试能力
验证是否生效:跑一次迁移或查一条数据
配置完别只看编译通过,实际连一下库最靠谱:
- 执行迁移命令:
dotnet ef migrations add Init→dotnet ef database update - 或在控制器里简单查一条:
await context.Users.FirstOrDefaultAsync(),看会不会抛出连接异常 - 如果报
Unable to connect to any of the specified MySQL hosts,八成是地址、端口、用户名或数据库名写错了
基本上就这些。不复杂但容易忽略细节,比如 MySQL 少了 ServerVersion、SQL Server 漏了 TrustServerCertificate=True(本地自签名证书场景),都会卡在第一步。










