.NET 4.5下ASP.NET Identity登录时IdentityUser的Id属性类型不匹配报错

基于ASP.NET Identity开发的邮箱登录功能，运行时触发如下错误：

The 'Id' property on 'IdentityUser`4' could not be set to a 'System.Int32' value. You must set this property to a non-null value of type 'System.String'.

错误触发位置为调用SignInManager.PasswordSignInAsync的登录逻辑行，所有测试场景均可复现，项目基于.NET Framework 4.5，使用ASP.NET Identity官方示例库开发。

报错核心成因 #

• 首先澄清容易误解的点：错误提示里的IdentityUser`4不是代码里定义的异常类型，这是.NET运行时对携带4个泛型参数的泛型类型的标准显示规则（反引号后的数字代表类型定义时的泛型参数数量，也叫元数标记），不属于异常标记。
• 本质冲突是实体定义和数据库表结构的主键类型不匹配：
  • 按照现有代码的定义，ApplicationUser继承自无额外泛型参数的IdentityUser，对应默认约定是Id属性为string类型
  • 但当前连接的giftsmart_live数据库中，用户表的Id字段是int自增类型，属于之前基于自定义整数主键改造过的Identity表结构
  • 当EF从数据库读取用户记录、尝试把int类型的Id值赋值给代码中定义的string类型Id属性时，就会直接触发类型转换错误
• 附带的配置错误放大了问题：
  • 代码在静态构造函数中，错误地把数据库初始化器绑定到了业务实体上下文GiftSmartContext，而非Identity所属的ApplicationDbContext
  • 自定义硬编码的GetConnectionString方法没有被注入到DbContext构造逻辑中，导致上下文无法正确匹配实体和表结构的映射关系，直接触发了类型校验错误

解决方法 #

• 第一步：对齐主键类型，二选一匹配现有环境
  • 若保留现有数据库的int主键结构：调整ApplicationUser和相关Identity组件的泛型定义，适配int类型主键

    // 适配int主键的用户类定义
    public class ApplicationUser : IdentityUser<int, IdentityUserLogin<int>, IdentityUserRole<int>, IdentityUserClaim<int>>
    {
        // 保留原有GenerateUserIdentityAsync方法逻辑
    }
    // 适配int主键的数据库上下文定义
    public class ApplicationDbContext : IdentityDbContext<ApplicationUser, IdentityRole<int>, int, IdentityUserLogin<int>, IdentityUserRole<int>, IdentityUserClaim<int>>
    {
        // 保留原有构造函数逻辑
    }
    

    同时需要对应调整UserManager、SignInManager的泛型参数，匹配int主键的类型约定。
  • 若保留现有代码的string主键定义：修改数据库中所有AspNet开头的Identity表结构，将Id字段从int自增改为字符串类型（通常存储GUID即可），完全匹配代码的默认映射约定。
• 第二步：修正数据库上下文配置错误
  • 把静态构造函数中错误绑定到GiftSmartContext的初始化器逻辑，改为绑定到ApplicationDbContext类型
  • 要么在Web.config中配置名称为GiftSmartContext的连接字符串，让DbContext基类构造函数能正确读取配置；要么修改ApplicationDbContext的构造函数，将硬编码的连接串直接传入基类构造，避免连接逻辑落空
  • 不要混淆业务数据上下文和Identity权限上下文，两个独立的DbContext不要共用初始化配置
• 第三步：优化登录逻辑的异常兜底
  原逻辑在根据邮箱查询用户后，没有判断空值场景，若邮箱不存在会触发空引用错误，可补充判断逻辑：

  var user = SignInManager.UserManager.Users.Where(u => u.Email == model.Email).FirstOrDefault();
  if (user == null)
  {
      ModelState.AddModelError("", "Invalid login attempt.");
      return View(model);
  }
  

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