Core 2 Identity：重新生成邮箱确认链接的实现问题

这个需求在ASP.NET Core Identity的实际开发中挺常见的，我来一步步给你拆解实现思路和代码：

1. 捕获登录时的IsNotAllowed状态 #

首先要在登录的POST处理逻辑里，判断登录结果的状态。当返回IsNotAllowed时（这就是用户未完成邮箱确认的触发条件），引导用户到重新发送确认邮件的页面，同时可以把用户的邮箱或ID传递过去，避免用户重复输入。

示例代码（以Razor Pages为例，MVC逻辑完全通用）：

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl ??= Url.Content("~/");

    if (ModelState.IsValid)
    {
        var result = await _signInManager.PasswordSignInAsync(Input.Email, Input.Password, Input.RememberMe, lockoutOnFailure: false);
        if (result.Succeeded)
        {
            _logger.LogInformation("User logged in.");
            return LocalRedirect(returnUrl);
        }
        // 重点处理未确认邮箱的分支
        if (result.IsNotAllowed)
        {
            var user = await _userManager.FindByEmailAsync(Input.Email);
            if (user != null)
            {
                // 用TempData传递用户信息，避免重复输入
                TempData["UserId"] = user.Id;
                TempData["UserEmail"] = user.Email;
            }
            // 跳转到重新发送确认邮件的页面
            return RedirectToPage("/Account/ResendEmailConfirmation");
        }
        // 其他登录状态分支（双因素、锁定等）保留原有逻辑
        if (result.RequiresTwoFactor)
        {
            return RedirectToPage("./LoginWith2fa", new { ReturnUrl = returnUrl, RememberMe = Input.RememberMe });
        }
        if (result.IsLockedOut)
        {
            _logger.LogWarning("User account locked out.");
            return RedirectToPage("./Lockout");
        }
        else
        {
            ModelState.AddModelError(string.Empty, "Invalid login attempt.");
            return Page();
        }
    }

    // 验证失败时返回登录页
    return Page();
}

2. 创建重新发送确认邮件的页面与逻辑 #

接下来创建ResendEmailConfirmation页面（或MVC控制器Action），让用户可以触发重新发送操作。

页面UI示例（Razor Pages） #

@page
@model ResendEmailConfirmationModel
@{
    ViewData["Title"] = "重新发送邮箱确认邮件";
}

<h1>@ViewData["Title"]</h1>

<div class="row">
    <div class="col-md-4">
        @if (TempData["StatusMessage"] != null)
        {
            <div class="alert alert-success">@TempData["StatusMessage"]</div>
        }
        <form method="post">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="Email" class="control-label"></label>
                <input asp-for="Email" class="form-control" value="@TempData["UserEmail"]" readonly />
                <span asp-validation-for="Email" class="text-danger"></span>
            </div>
            <button type="submit" class="btn btn-primary">重新发送确认邮件</button>
        </form>
    </div>
</div>

后台处理逻辑 #

public class ResendEmailConfirmationModel : PageModel
{
    private readonly UserManager<IdentityUser> _userManager;
    private readonly IEmailSender _emailSender;
    private readonly HtmlEncoder _htmlEncoder;

    public ResendEmailConfirmationModel(UserManager<IdentityUser> userManager, IEmailSender emailSender, HtmlEncoder htmlEncoder)
    {
        _userManager = userManager;
        _emailSender = emailSender;
        _htmlEncoder = htmlEncoder;
    }

    [BindProperty]
    public string Email { get; set; }

    public void OnGet()
    {
        // 从TempData获取之前传递的邮箱
        Email = TempData["UserEmail"] as string;
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (!ModelState.IsValid)
        {
            return Page();
        }

        var user = await _userManager.FindByEmailAsync(Email);
        if (user == null)
        {
            ModelState.AddModelError(string.Empty, "无法找到该邮箱对应的用户。");
            return Page();
        }

        // 先检查用户是否已经确认邮箱，避免无效操作
        if (await _userManager.IsEmailConfirmedAsync(user))
        {
            ModelState.AddModelError(string.Empty, "该邮箱已经完成确认，请直接登录。");
            return Page();
        }

        // 生成全新的邮箱确认令牌（旧令牌会自动失效）
        var token = await _userManager.GenerateEmailConfirmationTokenAsync(user);
        // 生成确认链接
        var callbackUrl = Url.Page(
            "/Account/ConfirmEmail",
            pageHandler: null,
            values: new { userId = user.Id, code = token },
            protocol: Request.Scheme);

        // 复用你之前的邮件发送逻辑即可
        await _emailSender.SendEmailAsync(
            Email,
            "确认你的邮箱",
            $"请点击以下链接确认你的邮箱: <a href='{_htmlEncoder.Encode(callbackUrl)}'>点击这里</a>");

        // 给用户反馈
        TempData["StatusMessage"] = "新的确认邮件已发送到你的邮箱，请查收。";
        return RedirectToPage();
    }
}

3. 关键细节提示 #

• 令牌有效性：每次调用GenerateEmailConfirmationTokenAsync都会生成全新的令牌，旧令牌会自动失效，避免了重复使用的安全问题。
• 用户体验优化：通过TempData传递用户邮箱，减少用户输入步骤；如果是公共场景，也可以放开邮箱输入框，让用户手动填写后后台查找用户。
• 边界情况处理：一定要检查用户是否已经确认邮箱，避免无效发送；同时处理用户不存在的情况，给出友好提示。

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