Entity Framework Core配置PersistKeysToDbContext对接MySQL触发空引用异常

常见原因及排查步骤 #

1. 检查DataProtectionKeysContext定义是否正确 #

PersistKeysToDbContext内部依赖固定名称的DbSet<DataProtectionKey>，漏写该属性会直接触发空引用异常，正确定义示例：

using Microsoft.AspNetCore.DataProtection.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;

public class DataProtectionKeysContext : DbContext, IDataProtectionKeyContext
{
    public DataProtectionKeysContext(DbContextOptions<DataProtectionKeysContext> options) 
        : base(options) { }

    // 必须显式声明该DbSet，名称不能修改
    public DbSet<DataProtectionKey> DataProtectionKeys { get; set; }
}

注意必须提前安装Microsoft.AspNetCore.DataProtection.EntityFrameworkCoreNuGet包，且Context实现IDataProtectionKeyContext接口。

2. 检查MySQL驱动配置是否正确 #

• 优先使用Pomelo.EntityFrameworkCore.MySql驱动，Oracle官方MySQL驱动对.NET Core的兼容性较差
• 新版本Pomelo驱动的UseMySql方法必须显式指定MySQL版本，缺失版本参数会导致DbContext初始化失败，修改后的配置代码示例：

services.AddDbContext<DataProtectionKeysContext>(options =>
    options.UseMySql(
        // 先验证该扩展方法能正常返回非空的有效连接字符串
        this.Configuration.GetMySQLConnectionString("ConnectionOptions:XXX"),
        // 替换为你实际使用的MySQL版本号
        new MySqlServerVersion(new Version(8, 0, 33))
    ))
.AddDataProtection()
.PersistKeysToDbContext<DataProtectionKeysContext>();

3. 检查数据库初始化是否完成 #

• 验证配置的连接字符串对应的MySQL实例可以正常访问，权限配置正确
• 执行EF Core迁移生成DataProtectionKeys表：
  1. 包管理器控制台执行：Add-Migration AddDataProtectionKeys
  2. 执行：Update-Database
     也可以在程序启动入口调用dataProtectionKeysContext.Database.Migrate()自动完成迁移。

4. 检查服务注册顺序 #

DataProtection的注册逻辑必须放在Authentication、Session、Identity等依赖数据保护的服务注册之前，顺序颠倒会导致依赖服务初始化时数据保护未完成配置，触发空引用。

5. 快速定位验证 #

临时修改配置使用本地文件存储密钥，验证是否是数据库持久化逻辑导致的异常：

services.AddDataProtection()
    .PersistKeysToFileSystem(new DirectoryInfo(@"C:\temp\data-protection-keys"));

若修改后异常消失，即可确认问题出在数据库持久化相关配置，优先排查前面3个步骤。

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