Azure EF自动创建UserItems表失败，插入数据报内部服务器错误

一、自动建表失败的核心原因排查及修复 #

1. 确认数据库初始化逻辑的执行与权限 #

EnsureCreatedAsync仅会创建数据库和表，但不会处理迁移，且如果执行过程中出现异常（如数据库账户无建表权限、连接字符串指向错误实例）会静默失败。

• 修改InitializeDatabaseAsync添加异常捕获，明确错误原因：

  public async Task InitializeDatabaseAsync()
  {
      try
      {
          await this.Database.EnsureCreatedAsync().ConfigureAwait(false);
          // 或改用迁移模式（推荐，支持后续 schema 变更）
          // await this.Database.MigrateAsync().ConfigureAwait(false);
      }
      catch (Exception ex)
      {
          // 输出日志或直接抛出，便于排查权限/连接问题
          Console.WriteLine($"数据库初始化失败：{ex.Message}");
          throw;
      }
  }
  

• 验证连接字符串指向的数据库实例是否为SSMS中查看的目标库，同时确保数据库登录账户拥有创建表、修改Schema的权限。

2. 修复实体与数据库的映射配置 #

EntityTableData基类包含Id、Version、CreatedAt等系统字段，EF Core需正确映射这些字段才能生成合法表结构：
在AppDbContext中添加OnModelCreating方法，显式配置映射规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 强制指定表名，避免EF约定冲突
    modelBuilder.Entity<UserItem>().ToTable("UserItems");

    // 配置EntityTableData核心字段
    modelBuilder.Entity<UserItem>()
        .HasKey(x => x.Id);
    modelBuilder.Entity<UserItem>()
        .Property(x => x.Id)
        .IsRequired()
        .HasMaxLength(128); // 匹配SQL Server主键长度限制
    modelBuilder.Entity<UserItem>()
        .Property(x => x.Version)
        .IsRowVersion(); // 映射为SQL Server的ROWVERSION类型
    modelBuilder.Entity<UserItem>()
        .Property(x => x.CreatedAt)
        .IsRequired()
        .HasColumnType("datetimeoffset");
    modelBuilder.Entity<UserItem>()
        .Property(x => x.UpdatedAt)
        .HasColumnType("datetimeoffset");
}

3. 避免初始化逻辑的异步问题 #

确保数据库初始化在应用启动前完成，当前Program.cs中的逻辑是正确的，但可添加日志确认执行状态：

using (var scope = app.Services.CreateScope())
{
    var context = scope.ServiceProvider.GetRequiredService<AppDbContext>();
    Console.WriteLine("开始初始化数据库...");
    await context.InitializeDatabaseAsync().ConfigureAwait(false);
    Console.WriteLine("数据库初始化完成");
}

二、手动建表后能插入但无法读取的问题修复 #

此问题本质是手动表结构与实体映射不匹配，需严格对齐以下字段：

• Id：必须为nvarchar(128)类型，且设为主键
• Version：必须为timestamp/rowversion类型（自动生成）
• CreatedAt/UpdatedAt：必须为datetimeoffset类型
• Deleted：必须为bit类型

若手动表的字段类型与上述不符，EF Core查询时会因类型不匹配返回空结果，需重新创建符合映射规则的表。

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