C#中传入ClaimTypes.Email值初始化Guid触发FormatException是什么原因

异常触发的核心原因 #

new Guid(string) 只有传入完全符合Guid规范的字符串才能解析成功，你遇到报错大概率是以下几种场景：

• 传入的username为null或空字符串
  你代码中用了空值传播运算符?.，如果当前请求上下文不存在ClaimTypes.Email类型的声明，或者该声明的值为空，username最终会是null，直接传入Guid构造函数就会触发格式错误。
• 你从ClaimTypes.Email中取到的值本身就不是Guid格式
  正常来说ClaimTypes.Email存储的是用户邮箱（格式如xxx@example.com），本身就不符合xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的Guid结构，这是最常见的错误原因，大概率是你把存储用户ID的Claim类型搞错了，通常用户唯一标识会存储在ClaimTypes.NameIdentifier中。
• 字符串包含多余的不可见字符
  就算你确实在ClaimTypes.Email中存储了Guid字符串，也可能因为值前后存在空格、换行符、不可见控制字符导致解析失败。

修复方案 #

推荐使用Guid.TryParse做安全转换，避免抛出未捕获异常，同时先做非空校验，参考代码如下：

// 优先确认你是不是取错了Claim类型，正确的用户ID通常存在ClaimTypes.NameIdentifier下
// var userIdClaim = User.FindFirst(ClaimTypes.NameIdentifier);
var userIdClaim = User.FindFirst(ClaimTypes.Email);
if (userIdClaim == null || string.IsNullOrWhiteSpace(userIdClaim.Value))
{
    // 处理声明不存在的业务逻辑
}
else if (Guid.TryParse(userIdClaim.Value.Trim(), out var userId))
{
    // 转换成功，正常使用userId变量
}
else
{
    // 处理格式不符合要求的业务逻辑，比如记录日志、返回参数错误提示
}

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