ASP.NET Core表单传递ReturnUrl至控制器失败问题排查

核心原因 #

你当前的实现仅通过asp-route-returnurl将ReturnUrl拼在表单的action URL中，存在两个关键问题：

1. 参数丢失场景：当ModelState验证失败（比如登录密码错误），你返回View(model)时，ViewData["ReturnUrl"]已经是null（第一次POST时returnurl参数未被正确传递，或传递后未重新存入ViewData），导致重新渲染的表单action URL中不再包含returnurl参数，后续提交自然拿不到值。
2. POST参数传递方式：asp-route-*生成的是URL查询参数，而POST请求的参数通常通过表单体传递，仅依赖URL参数容易在页面重渲染时丢失。

修复方案 #

方案1：添加隐藏域持久化ReturnUrl

在表单中添加隐藏域，直接将ReturnUrl作为表单字段提交，确保每次POST都能传递该值：

<form asp-controller="Account" asp-action="Login" method="post" role="form">
    <h4>Use a local account to log in.</h4>
    <hr />
    <div asp-validation-summary="All" class="text-danger"></div>
    <!-- 添加隐藏域传递ReturnUrl -->
    <input type="hidden" name="returnurl" value="@ViewData["ReturnUrl"]" />
    
    <!-- 原有表单字段保持不变 -->
    <div class="form-group">
        <label asp-for="Email" class="col-md-2"></label>
        <div class="col-md-10">
            <input asp-for="Email" class="form-control" />
            <span asp-validation-for="Email" class="text-danger"></span>
        </div>
    </div>
    <!-- 其余字段省略 -->
</form>

方案2：将ReturnUrl加入ViewModel（更规范）

把ReturnUrl整合到LoginViewModel中，通过强类型绑定传递：

public class LoginViewModel
{
    public string Email { get; set; }
    public string Password { get; set; }
    public bool RememberMe { get; set; }
    // 添加ReturnUrl属性
    public string ReturnUrl { get; set; }
}

视图中使用强类型隐藏域：

<input asp-for="ReturnUrl" type="hidden" />

修正POST Action逻辑

确保在ModelState验证失败返回视图时，将ReturnUrl重新赋值回ViewData或ViewModel，避免丢失：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Login(LoginViewModel model, string returnurl = null)
{
    // 优先从ViewModel获取ReturnUrl，兜底处理默认值
    var actualReturnUrl = model.ReturnUrl ?? returnurl ?? Url.Content("~/");
    ViewData["ReturnUrl"] = actualReturnUrl;

    if (ModelState.IsValid)
    {
        var result = await _signInManager.PasswordSignInAsync(
            model.Email, model.Password, model.RememberMe, lockoutOnFailure: true);
        
        if (result.Succeeded)
        {
            return LocalRedirect(actualReturnUrl);
        }
        else if (result.IsLockedOut)
        {
            return View("Lockout");
        }
        else
        {
            ModelState.AddModelError(string.Empty, "Invalid login attempt.");
            // 返回视图前把ReturnUrl赋值回ViewModel
            model.ReturnUrl = actualReturnUrl;
            return View(model);
        }
    }

    // ModelState无效时，同样赋值ReturnUrl
    model.ReturnUrl = actualReturnUrl;
    return View(model);
}

确保GET Action正确传递ReturnUrl

检查你的GET Login方法，确保将传入的ReturnUrl存入ViewData或ViewModel：

[HttpGet]
public IActionResult Login(string returnurl = null)
{
    ViewData["ReturnUrl"] = returnurl;
    // 如果使用ViewModel：
    return View(new LoginViewModel { ReturnUrl = returnurl });
}

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