无副作用处理Razor Pages OnPost处理器中的错误

核心矛盾拆解 #

你遇到的是Razor Pages中Post-Redirect-Get(PRG)模式与ModelState保留的典型冲突：直接返回Page()能保留验证错误，但会留下POST请求的URL（如www.example.com/Foo?handler=OnPostAddCustomer），且用户刷新时会触发重复提交提示；用PRG能解决URL和刷新问题，但默认会丢失ModelState，手动用TempData传递又显得冗余。

官方内置解决方案：ModelStateTempDataTransfer 机制 #

ASP.NET Core本身提供了专门处理该场景的内置实现，无需手动封装TempData逻辑：

1. 启用中间件配置 #

在Program.cs中注册Razor Pages时，启用ModelStateTempDataTransfer支持，还可按需配置保留规则：

builder.Services.AddRazorPages()
    .AddMvcOptions(options =>
    {
        // 可选：仅保留包含错误的ModelState条目
        options.ModelStateTempDataTransferProviderOptions.Predicate = state => state.Errors.Count > 0;
    });

2. 在Post处理器中转移ModelState #

在PageModel中注入ITempDataDictionaryFactory，当验证失败时，将ModelState转移到TempData后执行重定向：

private readonly ITempDataDictionaryFactory _tempDataFactory;

public YourPageModel(ITempDataDictionaryFactory tempDataFactory)
{
    _tempDataFactory = tempDataFactory;
}

public IActionResult OnPostAddCustomer()
{
    if (!ModelState.IsValid)
    {
        using var tempData = _tempDataFactory.GetTempData(HttpContext);
        // 将当前ModelState存入TempData
        tempData.Put(ModelStateTempDataTransferProvider.Key, ModelState);
        
        return RedirectToPage();
    }

    // 执行正常业务逻辑
    return RedirectToPage("CustomerList");
}

3. 在Get处理器中恢复ModelState #

在OnGet中从TempData恢复ModelState，同时加载页面所需数据：

public void OnGet()
{
    using var tempData = _tempDataFactory.GetTempData(HttpContext);
    // 检查并恢复TempData中的ModelState
    if (tempData.TryGetValue(ModelStateTempDataTransferProvider.Key, out var modelStateObj) 
        && modelStateObj is ModelStateDictionary modelState)
    {
        ModelState.Merge(modelState);
    }

    // 加载页面初始化数据，比如客户列表、下拉选项等
    // Customers = _customerService.GetAll();
}

简化复用：自定义基类封装 #

为避免每个PageModel重复写恢复逻辑，可封装一个基类统一处理：

public class BasePageModel : PageModel
{
    private readonly ITempDataDictionaryFactory _tempDataFactory;

    public BasePageModel(ITempDataDictionaryFactory tempDataFactory)
    {
        _tempDataFactory = tempDataFactory;
    }

    public override void OnPageHandlerExecuting(PageHandlerExecutingContext context)
    {
        // 在所有处理器执行前统一恢复ModelState
        using var tempData = _tempDataFactory.GetTempData(context.HttpContext);
        if (tempData.TryGetValue(ModelStateTempDataTransferProvider.Key, out var modelStateObj) 
            && modelStateObj is ModelStateDictionary modelState)
        {
            ModelState.Merge(modelState);
        }

        base.OnPageHandlerExecuting(context);
    }

    protected void TransferModelStateToTempData()
    {
        using var tempData = _tempDataFactory.GetTempData(HttpContext);
        tempData.Put(ModelStateTempDataTransferProvider.Key, ModelState);
    }
}

后续PageModel只需继承基类，Post处理器中调用封装方法即可：

public class YourPageModel : BasePageModel
{
    public YourPageModel(ITempDataDictionaryFactory tempDataFactory) : base(tempDataFactory)
    {
    }

    public IActionResult OnPostAddCustomer()
    {
        if (!ModelState.IsValid)
        {
            TransferModelStateToTempData();
            return RedirectToPage();
        }

        // 业务逻辑处理
        return RedirectToPage("Success");
    }

    public void OnGet()
    {
        // 加载页面数据
    }
}

方案优势 #

• 这是官方标准化实现，完全遵循框架设计逻辑，无需自定义TempData键或手动序列化ModelState
• 可通过配置项统一控制ModelState保留规则，比如排除特定字段、仅保留错误信息
• 封装后代码复用性强，减少重复模板代码

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