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

畫卷琴夢 2025-12-26 00:00:00 次阅读

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