EntityFrameworkCore v1.1.1 问题汇总

随着宇宙第一IDE的最新版本发布[2017/3/7]，AspNetCore 和EntityFrameworkCore（团队）都发布了最新的代码。 Red rose

不过在我看来，这些到还不是最重要的。最重要的是dotnet cli终于rtm了，以及和它配套的各类工具。好鸡冻啊，终于不用管beta，preview，final，final-update之类的版本了。虽然今后一定还会有各类版本发布，但是本次发布之后，工具的很多使用方式和习惯都会定下来（一些），方便我们这种用户使用和记忆。

问题环境

为了跟进新本版，在安装了vs2017之后，我就迫不及待地搭建了一个项目进行测试。

项目	内容
EfCore11.Domain	Entity类型，不需要引用其他nuget包
EfCore11.DataSqlServer	DbContext项目，需要引用Microsoft.EntityFrameworkCore.SqlServer等nuget包
EfCore11.SomeUI	AspnetCore MVC项目，可以通过dotnet new mvc命令生成

其中的项目文件：

Domain项目中的Blog.cs文件

  1 using System.Collections.Generic;
  2 
  3 namespace EfCore11.Domain
  4 {
  5     public class Blog
  6     {
  7         public int Id { get; set; }
  8         public string Name { get; set; }
  9         public string Url { get; set; }
 10         public ICollection<Post> Posts { get; set; }
 11     }
 12 }
 13

Domain项目中的Post.cs文件

  1 namespace EfCore11.Domain
  2 {
  3     public class Post
  4     {
  5         public int Id { get; set; }
  6         public string Title { get; set; }
  7         public string Body { get; set; }
  8 
  9         public int BlogId { get; set; }
 10         public Blog Blog { get; set; }
 11     }
 12 }
 13

DataSqlServer项目中的BlogDbContext.cs文件

  1 using EfCore11.Domain;
  2 using Microsoft.EntityFrameworkCore;
  3 
  4 namespace EfCore11.DataSqlServer
  5 {
  6     public class BlogDbContext : DbContext
  7     {
  8         public DbSet<Post> Post { get; set; }
  9         public DbSet<Blog> Blog { get; set; }
 10 
 11         public BlogDbContext(DbContextOptions<BlogDbContext> option)
 12             : base(option)
 13         {
 14 
 15         }
 16     }
 17 }

SomeUI项目中Startup.cs文件中修改的代码

  1 public void ConfigureServices(IServiceCollection services)
  2 {
  3     // Add framework services.
  4     services.AddMvc();
  5     // 此处不用json配置的方法了，因为不是本文的重点。如有需要请自行baidu
  6     string conn = "server=(localdb)\\mssqllocaldb;database=Ef.Core;Trusted_connection=true;";
  7     services.AddDbContext<BlogDbContext>(opt => opt.UseSqlServer(conn));
  8 }

问题0：在哪个项目上执行 code first migration 呢？

按照现在的项目机构，可以执行code first migration 的项目有两个：分别是DbContext项目，也就是本文环境中的DataSqlServer项目；以及Mvc项目，也就是本文中的SomeUI项目。

这两个项目都可以完成数据库迁移所需的操作，但是实现目有所不同。因为在哪个项目内完成迁移就意味着要由哪个项目中维护相应的迁移代码，而用于生产环境的MVC项目是不会包含全部数据库迁移代码的（理由很多了，谁也不会把包含“简历生成事件”的代码放到生产环境上的），所以通常情况下的开发项目采用DbContext项目管理迁移代码，测试环境随意。

先说简单的，在MVC环境下迁移：

问题1：执行 dotnet ef 命令错误

重现方法：CMD打开SomeUI目录，然后执行“dotnet ef”命令

报错内容：No executable found matching command "dotnet-ef"

问题解释：ef core编写时其内容被拆分成为了很多包，以方便程序员只加载程序所需的代码，这样程序就会占用更小的内存，运行速度更快，部署更容易。所以想要运行dotnet-ef命令，还需要加载Microsoft.EntityFrameworkCore.Tools.DotNet

此包的描述是这样的

处理方法：因为目前dotnet cli还没有直接添加命令行工具引用的方法，所以只能暴力一点儿了，直接修改csproj文件：

在ProjectGroup标签下直接添加：

  1   <ItemGroup>
  2     <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="1.0.0" />
  3   </ItemGroup>

//添加完毕后，如果你的vs出现了一些奇怪的现象，比如nuget包没有加载，引用不正常，可以尝试关闭当前的项目，然后重新打开项目来解决这个问题。

//看上去就是项目文件没有在修改后重新加载，希望update1的时候能够更稳定一些。

修复检查：重新执行dotnet ef，能看到独角兽啊

问题2：执行 dotnet ef migrations add initial 报错

重现方法：CMD打开SomeUI目录，执行“dotnet ef migrations add initial”

报错内容：Could not load file or assembly 'Microsoft.EntityFrameworkCore.Design, Culture=neutral, PublicKeyToken=null'. 绯荤粺鎵句笉鍒版寚瀹氱殑鏂囦欢銆

问题解释：和上一个问题一样，而且错误信息也说的比较明确，就是还缺少一个nuget包：Microsoft.EntityFrameworkCore.Design

处理方法：在cli下的添加方式是执行：dotnet add package Microsoft.EntityFrameworkCore.Design

修复检查：再次执行dotnet ef migrations add initial ，报错信息更改了：

问题3：迁移报错，需要指定包含迁移的程序集

重现方法：详见问题2

报错内容：Your target project 'xxxxx' doesn't match your migrations assembly xxxxxxxx'. Either change your target project or change your migrations assembly.

问题解释：当前执行迁移项目和包含DbContext程序集项目不一致，要么更改执行迁移操作的项目，要么修改迁移程序集。

处理方法：两条路自己选，要么切换到用DbContext程序集管理迁移代码，要么修改当前代码以适应迁移方法。错误信息里给出了一个简单的解决方法：

Change your migrations assembly by using DbContextOptionsBuilder. E.g. options.UseSqlServer(connection, b => b.MigrationsAssembly("EfCore11.SomeUI")). By default, the migrations assembly is the assembly containing the DbContext.
Change your target project to the migrations project by using the Package Manager Console's Default project drop-down list, or by executing "dotnet ef" from the directory containing the migrations project.

对应修改的代码是SomeUI项目的Startup.cs文件

  1 public void ConfigureServices(IServiceCollection services)
  2 {
  3     // Add framework services.
  4     services.AddMvc();
  5     // 此处不用json配置的方法了，因为不是本文的重点。如有需要请自行baidu
  6     string conn = "server=(localdb)\\mssqllocaldb;database=Ef.Core;Trusted_connection=true;";
  7     services.AddDbContext<BlogDbContext>(opt => opt.UseSqlServer(conn
  8         ,b=>b.MigrationsAssembly("EfCore11.SomeUI")

  9         ));
 10 }

修复检查：重新执行迁移命令，成功。

之后再执行“dotnet ef database update”就可以按照现有代码迁移，创建相应的数据库了。

至此，简单的代码迁移过程完成了。不过以上流程的解决方案不用划分为三个项目也可以实现，如果想要实现复杂项目或者用于部署身缠环境的方案，还需要过以下坑。

使用DbContext项目迁移：

对于环境和代码改动需要回滚到问题0。然后使用CMD打开DataSqlServer目录。

执行 dotnet ef命令，会遇到问题1，问题2的错误，根据描述进行修改即可，不过需要注意项目已经更换，不要改错地方了：）

问题4：ef tooling 对于.NetStandard的支持问题

重现方法：CMD执行代码迁移

报错内容：Startup project 'EfCore11.DataSqlServer.csproj' targets framework '.NETStandard'. This framework is not intended for execution and may fail to resolve runtime dependencies. If so, specify a different project using the --startup-project option and try again.

问题解释：这不是很严重的问题，所以错误用黄色显示。因为当前版本的EF 命令行工具对于.NetStandard支持有限，所以会出现一个警告信息。如果真的想要修改这个问题，目前只能通过修改csproj文件，将targetFramework修改为netcoreapp1.1.

问题5：无法初始化DbContext

重现方法：CMD执行代码迁移

报错内容：No parameterless constructor was found on 'BlogDbContext'. Either add a parameterless constructor to 'BlogDbContext' or add an implementation of 'IDbContextFactory<BlogDbContext>' in the same assembly as 'BlogDbContext'.

问题解释：因为文中的DbContext 没有给出无参构造器，要么给出无参构造器，要么实现IDbContextFactory。此处又出现了分支，按惯例，先说简单的：通过-s|—startup-project参数让mvc程序注入一个“'IDbContextFactory<BlogDbContext>”，这样DbContext 就可以正常初始化了。

相对比较复杂的方法需要修改代码，详见问题6.

处理方法：CMD执行行命令“dotnet ef migrations add initialCreate -s ..\EfCore11.SomeUI”

修复检查：

问题6：实现无参构造器的DbContext参与迁移

重现方法：

修改代码：DataSqlServer的BlogDbContext.cs文件

  1 using EfCore11.Domain;
  2 using Microsoft.EntityFrameworkCore;
  3 
  4 namespace EfCore11.DataSqlServer
  5 {
  6     public class BlogDbContext : DbContext
  7     {
  8         public DbSet<Post> Post { get; set; }
  9         public DbSet<Blog> Blog { get; set; }
 10 
 11         //public BlogDbContext(DbContextOptions<BlogDbContext> option)
 12         //    : base(option)
 13         //{
 14 
 15         //}
 16 
 17         // 因为使用无参构造器，所以需要自带链接字符串
 18         protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
 19         {
 20             optionsBuilder.UseSqlServer("server=(localdb)\\mssqllocaldb;database=Ef.Core;Trusted_connection=true;");
 21         }
 22     }
 23 }

执行命令：dotnet ef migrations add initialCreate

再执行命令：dotnet ef database update

报错内容：Could not load file or assembly 'System.Data.SqlClient, Version=4.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. 绯荤粺鎵句笉鍒版寚瀹氱殑鏂囦欢銆

或：Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.1.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)

问题解释：错误信息不同是因为DbContext项目使用了不同的targetFramework，如果是targetFramework=netstandard1.4，则错误为无法加载System.Data.SqlClient，如果按照问题4修改了targetFramework=netcoreapp1.1，则错误为无法加载 System.Diagnostics.DiagnosticSource。

这个问题确实很奇葩，从错误信息完全不能弄清到底该怎么处理。目前ef team给出的解决办法有点儿绕，又使用了MVC项目。我相信这个解决方法只是一个临时处理措施，后期EF Team会妥善处理这个问题。

处理方法：CMD执行行命令“dotnet ef database update -s ..\EfCore11.SomeUI” //walkaround

修复检查：执行命令时会显示创建数据库的sql语句