ASP.NET Core 2.1 OnPost模型绑定失效 myCount为0仍进判断块报空引用

API 探路者

2026-9-2

问题根因

这个异常是ASP.NET Core 2.1 Razor Pages开发报表功能时的高频问题，触发原因按出现概率从高到低排序如下：

OnPost方法内赋值的是同名局部变量，未修改PageModel实例的公共属性myCount。很多开发者写查询逻辑时会顺手声明var myCount = queryResult.Count()这类局部变量，该变量作用域仅限方法内部，和视图读取的Model.myCount完全无关，模型属性会保留生命周期内的初始值（多为OnGet阶段赋值的旧值或类型默认值），最终导致判断分支逻辑和预期不符。
myCount定义不符合Razor视图取值规则：如果myCount是公共字段、静态属性、非public属性，2.1版本的视图渲染逻辑会出现取值不一致的问题，后端赋值和前端读取的值不匹配。
模型绑定顺序覆盖属性值：如果给myCount标记了[BindProperty]特性，且表单中存在同名表单项/隐藏域，请求值的绑定可能覆盖后端赋值；如果myCount定义为object/string等弱类型，和数值0的比较逻辑会出现非预期结果。
返回方法错误：如果OnPost逻辑末尾调用RedirectToPage()跳转回当前页，Post阶段给属性、ViewData赋的值会全部丢失，页面会重新执行OnGet方法初始化模型，值会被重置。

修复方案

按以下顺序排查修改即可彻底解决问题：

修正OnPost内的赋值逻辑，明确给当前实例的属性赋值，不要声明同名局部变量覆盖作用域
错误写法示例：

public IActionResult OnPost()
{
    // 错误：声明了同名局部变量，未修改模型属性
    var myCount = _reportRepository.QueryCount(QueryParameters);
    return Page();
}

正确写法示例：

public IActionResult OnPost()
{
    // 明确给当前PageModel实例的属性赋值
    this.myCount = _reportRepository.QueryCount(QueryParameters);
    // 仅在查询结果非空时给ViewData赋值，从后端逻辑层面避免空引用
    if (this.myCount > 0)
    {
        ViewData["reportDate"] = DateTime.Now.ToString("yyyy-MM-dd");
        // 其他报表明细数据赋值逻辑
    }
    return Page();
}

修正myCount的定义，必须为公共实例强类型属性，禁止使用字段、静态属性、非public属性、弱类型
正确定义示例：

public class ReportModel : PageModel
{
    // 正确：公共实例属性，强类型int
    public int myCount { get; set; }
    // 其余查询参数、报表数据属性
}

错误定义示例（均会导致取值异常）：

public class ReportModel : PageModel
{
    // 错误：公共字段
    public int myCount;
    // 错误：静态属性，多请求共享会串值
    public static int myCount { get; set; }
    // 错误：非public属性，视图无读取权限
    internal int myCount { get; set; }
    // 错误：弱类型，比较逻辑会出现非预期结果
    public object myCount { get; set; }
}

优化视图层判断逻辑，增加类型校验和空值防护，双重保险避免异常
不要直接写裸的数值判断，改成强类型校验，同时对ViewData取值做空值保护：

@* 先做类型校验，再做数值比较 *@
@if (Model.myCount is int validCount && validCount > 0)
{
    <div class="report-content">
        @* ViewData取值加空判断，即使逻辑异常也不会抛出空引用 *@
        <p>报表统计日期：@(ViewData["reportDate"]?.ToString() ?? "无有效日期")</p>
        @* 其余报表内容渲染 *@
    </div>
}
else
{
    <div class="empty-tip">未查询到符合条件的报表数据</div>
}

移除不必要的[BindProperty]标记：如果myCount仅用于后端给视图传值，不需要接收表单提交的绑定值，直接删掉属性上的[BindProperty]特性，同时删除页面中同名的隐藏域/表单项，避免请求值覆盖后端赋值。

注意：如果需要Post后跳转页面，不要用ViewData/模型属性传值，改用TempData传递结果标识，跳转后的OnGet方法根据标识初始化模型即可。

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