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<AppDbContext>(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(本地自签名证书场景),都会卡在第一步。
