Razor Pages仅首次加载时模型绑定生效，重载时绑定失效问题咨询

排查方向及修复步骤 #

1. 检查[BindProperty]特性的使用 #

PageModel里的表单绑定属性必须标记[BindProperty]，而且得是可读写的（同时有get和set访问器）。要是只写了get没set，或者漏加了特性，后续请求肯定绑不上值：

public class IndexModel : PageModel
{
    [BindProperty] // 必须添加该特性
    public string Username { get; set; } // 不能仅保留get访问器

    public IActionResult OnPost()
    {
        // 业务处理逻辑
        return Page();
    }
}

2. 确认表单提交的基本配置 #

• 表单的method必须设为post，Razor Page默认通过OnPost方法处理提交请求，用get会触发OnGet，无法触发绑定逻辑。
• 用asp-page指定正确的页面路由，避免表单提交到错误地址导致上下文丢失：

<form method="post" asp-page="./Index">
    <input asp-for="Username" />
    <button type="submit">提交</button>
</form>

3. 排查页面缓存问题 #

如果PageModel添加了[ResponseCache]这类缓存特性，后续请求可能返回缓存的旧页面，导致绑定上下文失效。先临时注释缓存特性测试：

// 先注释该特性，验证是否恢复正常
// [ResponseCache(Duration = 60)]
public class IndexModel : PageModel
{
    // ...
}

4. 检查自定义过滤器/绑定器的干扰 #

如果项目中存在自定义模型绑定器、Action过滤器或Page过滤器，可能在后续请求中破坏了默认绑定流程。可以临时注释这些自定义代码，测试绑定是否恢复，逐步定位问题点。

5. 核对表单字段与属性的名称匹配 #

不要手动修改表单字段的name属性，务必使用asp-for自动生成，确保字段名与PageModel中的属性名完全对应。比如属性是User.Email，表单字段必须为User.Email，手动修改name会直接导致绑定失败：

<!-- 正确写法 -->
<input asp-for="User.Email" />
<!-- 错误写法，无法完成绑定 -->
<input name="UserEmail" />

6. 验证会话状态是否正常 #

如果页面依赖会话功能，检查后续请求中会话是否丢失。可通过注入IHttpContextAccessor验证：

private readonly IHttpContextAccessor _httpContextAccessor;

public IndexModel(IHttpContextAccessor httpContextAccessor)
{
    _httpContextAccessor = httpContextAccessor;
}

public IActionResult OnPost()
{
    bool sessionAvailable = _httpContextAccessor.HttpContext.Session.IsAvailable;
    // 若会话不可用，需检查会话配置是否存在问题
    return Page();
}

调试小技巧 #

• 在OnPost方法开头检查ModelState.IsValid，若为false，查看ModelState.Errors的具体信息，可精准定位绑定失败的字段及原因。
• 使用浏览器开发者工具（F12）查看网络请求中的Form Data，确认提交的字段名称和值是否正确发送至服务器。

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