ASP.NET MVC 5 Identity第三方登录抛出System.ArgumentNullException求助

我之前在做类似功能时踩过一模一样的坑，这个异常大概率是Identity关联用户时依赖的核心字段缺失或未正确赋值导致的，下面是我亲测有效的排查和解决步骤：

1. 先确认谷歌返回的Claims是否包含Identity必需字段 #

Identity的第三方登录依赖NameIdentifier这个唯一标识Claim来关联用户，谷歌默认返回的是sub字段，有时候会出现映射不匹配的情况。你可以在ExternalLoginCallback方法里先调试查看返回的Claims：

// 在调用ExternalSignInAsync前添加这段代码调试
var claims = loginInfo.ExternalIdentity.Claims;
// 查看claims里是否包含Type为ClaimTypes.NameIdentifier的项，或者有没有"sub"字段

如果发现NameIdentifier缺失，直接在谷歌认证配置里手动映射：

// Startup.Auth.cs里的谷歌认证配置
app.UseGoogleAuthentication(new GoogleOAuth2AuthenticationOptions()
{
    ClientId = "你的谷歌ClientId",
    ClientSecret = "你的谷歌ClientSecret",
    // 手动将谷歌的"sub"字段映射为Identity需要的NameIdentifier
    ClaimActions.MapJsonKey(ClaimTypes.NameIdentifier, "sub")
});

2. 检查用户注册时的必填字段是否全部赋值 #

第一次用谷歌注册时，你在ExternalLoginConfirmation方法创建ApplicationUser的代码里，有没有给所有数据库必填字段赋值？比如：

• 如果你的ApplicationUser自定义了必填字段（比如FullName），但谷歌没返回该字段，又没设置默认值，会导致用户记录存库后该字段为空；
• 系统默认的字段比如EmailConfirmed，如果数据库设为NOT NULL但你没赋值，也会留下隐患。

举个正确的示例，确保所有必填字段都有值：

var user = new ApplicationUser { UserName = loginInfo.Email, Email = loginInfo.Email };
// 自定义必填字段如果谷歌没返回，设置默认值
user.FullName = loginInfo.ExternalIdentity.FindFirst(ClaimTypes.Name)?.Value ?? "未知用户";
// 系统默认必填字段也要确保赋值
user.EmailConfirmed = true;
var result = await UserManager.CreateAsync(user);

3. 检查数据库用户表的字段约束 #

直接打开你的数据库，查看AspNetUsers表的字段属性：

• 找出所有标记为NOT NULL的字段；
• 对比现有用户记录，看看有没有字段是空值（尤其是第三方登录创建的用户）。
  如果存在必填字段为空的情况，要么修改字段允许为空，要么在注册时补全该字段的值。

4. 捕获内层异常精准定位 #

外层异常信息往往被包装了，你可以通过捕获InnerException来找到具体是哪个值未定义：

try
{
    var result = await SignInManager.ExternalSignInAsync(loginInfo, isPersistent: false);
}
catch (Exception ex)
{
    // 这里打印或调试查看InnerException，能直接看到是哪个字段出了问题
    var detailedError = ex.InnerException?.Message;
}

最常见的情况就是NameIdentifierClaim映射错误，或者用户表必填字段为空，按照上面的步骤排查，基本能解决问题。

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