EF Core怎么配置连接字符串 EF Core配置连接字符串教程

来源:这里教程网 时间:2026-02-21 17:35:36 作者:

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

相关推荐