EF Code First执行Update-Database时连接字符串格式报错排查

我有一个使用EF的测试应用，通过Context Factory创建上下文用于迁移。执行Add-Migration可成功生成合适的迁移文件，但执行Update-Database时出现错误。

上下文工厂代码如下：

public class ContextFactory: IDesignTimeDbContextFactory<DBContext>
{
    public DBContext CreateDbContext(string[] args)
    {
        var optionsBuilder = new DbContextOptionsBuilder<DBContext>();
        
        optionsBuilder.UseSqlite("Data Source=C:\\tmp\\sqlite.db; Version=3;");
       
        return new DBContext(optionsBuilder.Options);
    }
}

报错信息如下：

PM> Update-Database
Build started...
Build succeeded.
System.ArgumentException: Format of the initialization string does not conform to specification starting at index 0.
   at System.Data.Common.DbConnectionOptions.GetKeyValuePair(String connectionString, Int32 currentPosition, StringBuilder buffer, Boolean useOdbcRules, String& keyname, String& keyvalue)
   at System.Data.Common.DbConnectionOptions.ParseInternal(Dictionary`2 parsetable, String connectionString, Boolean buildChain, Dictionary`2 synonyms, Boolean firstKey)
   at System.Data.Common.DbConnectionOptions..ctor(String connectionString, Dictionary`2 synonyms, Boolean useOdbcRules)
   at System.Data.Common.DbConnectionStringBuilder.set_ConnectionString(String value)
   at Microsoft.Data.Sqlite.SqliteConnectionStringBuilder..ctor(String connectionString)
   at Microsoft.Data.Sqlite.SqliteConnectionFactory.GetPoolGroup(String connectionString)
   at Microsoft.Data.Sqlite.SqliteConnection.set_ConnectionString(String value)
   at Microsoft.Data.Sqlite.SqliteConnection..ctor(String connectionString)
   at Microsoft.EntityFrameworkCore.Sqlite.Storage.Internal.SqliteRelationalConnection.CreateDbConnection()
   at Microsoft.EntityFrameworkCore.Storage.RelationalConnection.get_DbConnection()
   at Microsoft.EntityFrameworkCore.Diagnostics.RelationalLoggerExtensions.MigrateUsingConnection(IDiagnosticsLogger`1 diagnostics, IMigrator migrator, IRelationalConnection connection)
   at Microsoft.EntityFrameworkCore.Migrations.Internal.Migrator.Migrate(String targetMigration)
   at Microsoft.EntityFrameworkCore.Design.Internal.MigrationsOperations.UpdateDatabase(String targetMigration, String connectionString, String contextType)
   at Microsoft.EntityFrameworkCore.Design.OperationExecutor.UpdateDatabaseImpl(String targetMigration, String connectionString, String contextType)
   at Microsoft.EntityFrameworkCore.Design.OperationExecutor.UpdateDatabase.<>c__DisplayClass0_0.<.ctor>b__0()
   at Microsoft.EntityFrameworkCore.Design.OperationExecutor.OperationBase.Execute(Action action)
Format of the initialization string does not conform to specification starting at index 0.

我已通过SQLite Server Compact Toolbox验证该连接字符串有效，请问问题出在哪里？如何解决？以及如何获取更有效的错误数据来修复问题？

问题原因 #

尽管Add-Migration能正常使用Context Factory，但Update-Database命令可能未使用该工厂创建上下文：

1. 若DBContext存在无参构造函数，EF会优先尝试通过配置文件读取连接字符串，而非使用Context Factory；
2. 配置文件（如appsettings.json、app.config）中可能存在格式错误或为空的连接字符串，导致解析失败；
3. 连接字符串中的Version=3;属于冗余配置，虽不影响工具验证，但可能干扰EF的解析逻辑。

解决方法 #

• 强制EF使用Context Factory：确保DBContext仅保留带DbContextOptions<DBContext>参数的构造函数，删除无参或其他构造函数，让EF无论设计时还是运行时都必须依赖Options配置：

  public class DBContext : DbContext
  {
      public DBContext(DbContextOptions<DBContext> options) : base(options)
      {
      }
      // 移除其他构造函数
  }
  

• 显式指定上下文执行命令：在Package Manager Console中执行命令时，明确指定上下文类型：

  Update-Database -Context DBContext
  

• 简化连接字符串：移除冗余的Version=3;，SQLite默认使用版本3，简化后的字符串更稳定：

  optionsBuilder.UseSqlite("Data Source=C:\\tmp\\sqlite.db");
  

• 清理配置文件：检查项目中的配置文件，若存在未正确配置的连接字符串项，直接删除，避免EF读取错误配置。

获取更有效的错误数据 #

• 启用EF详细日志：在Context Factory中添加日志输出，查看EF内部的连接字符串读取过程：

  public DBContext CreateDbContext(string[] args)
  {
      var optionsBuilder = new DbContextOptionsBuilder<DBContext>();
      optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information); // 添加日志
      optionsBuilder.UseSqlite("Data Source=C:\\tmp\\sqlite.db");
      return new DBContext(optionsBuilder.Options);
  }
  

• 使用Verbose参数执行命令：在Package Manager Console中添加-Verbose参数，输出完整执行流程，包括连接字符串的来源：

  Update-Database -Verbose
  

• 调试连接字符串：在DBContext的构造函数中添加调试代码，查看实际使用的连接字符串：

  public DBContext(DbContextOptions<DBContext> options) : base(options)
  {
      var sqliteOptions = options.FindExtension<SqliteOptionsExtension>();
      Console.WriteLine($"实际使用的连接字符串：{sqliteOptions?.ConnectionString ?? "空"}");
  }
  

内容的提问来源于stack exchange，提问作者mans