ASP.NET Core表单PostBack时日期与整数字段输入值重置问题

API 探路者

2026-9-3

问题根因

这类表单回发后部分值类型字段丢失的问题，在ASP.NET Core MVC里几乎都是以下两个原因导致的：

输入框格式不兼容：出生日期字段一般用原生type="date"输入控件，该控件仅支持yyyy-MM-dd格式的ISO日期字符串。如果DateTime属性没有指定编辑模式下的输出格式，ASP.NET Core会按当前服务端文化设置输出日期（比如中文环境默认输出yyyy/MM/dd格式），浏览器识别为非法日期值就会渲染为空。int类型的入住人数字段同理，如果加了带非数字字符的显示格式（比如带单位后缀、千分位符），type="number"控件识别不了也会显示为空。
取值优先级冲突：ASP.NET Core TagHelper渲染表单值的优先级是 ModelState字典值 > 同名ViewData/ViewBag值 > 传入视图的模型属性值。如果POST验证失败时，你不小心清空了这两个字段对应的ModelState条目，或者ViewBag/ViewData里存在同名的空值（比如GET动作初始化时给同名ViewBag传了空值，POST返回时没覆盖），就会覆盖模型里用户已经输入的值，导致渲染为空。
极少数情况是自定义验证逻辑、或者POST返回时重新new了空视图模型，漏拷贝这两个字段的值，但这种情况一般会伴随更多字段值丢失，和“仅两个字段丢失”的特征不符。

修复方案

按以下顺序排查修复，99%的场景都能解决：

给两个值类型属性配置正确的编辑模式显示格式
在ApplicationFormViewModel中给对应属性添加DisplayFormat特性，确保输出值符合原生输入控件的格式要求：

// 出生日期输出为date控件支持的ISO格式
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime AppDateOfBirth { get; set; }

// 入住人数确保编辑时输出纯数字，不要带多余格式
[DisplayFormat(DataFormatString = "{0}", ApplyFormatInEditMode = true)]
public int AppTotalPersonsOccupy { get; set; }

视图中对应输入框不要手动写value属性，用TagHelper自动生成绑定值即可，示例：

<div class="mb-3">
    <label asp-for="AppDateOfBirth" class="form-label"></label>
    <input asp-for="AppDateOfBirth" class="form-control" type="date" />
    <span asp-validation-for="AppDateOfBirth" class="text-danger"></span>
</div>
<div class="mb-3">
    <label asp-for="AppTotalPersonsOccupy" class="form-label"></label>
    <input asp-for="AppTotalPersonsOccupy" class="form-control" type="number" min="1" />
    <span asp-validation-for="AppTotalPersonsOccupy" class="text-danger"></span>
</div>

修正POST动作验证失败的返回逻辑
验证失败时直接返回模型绑定生成的原视图模型实例，不要new新的空模型；下拉列表等存在ViewBag里的选项数据记得重新赋值即可，不要修改模型本身的用户输入值：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(ApplicationFormViewModel model)
{
    if (!ModelState.IsValid)
    {
        // 重新给下拉列表等需要ViewBag传的选项赋值即可，不要修改model的属性
        // 示例：ViewBag.ApartmentList = await GetApartmentOptionsAsync();
        return View(model); // 直接返回原绑定的model，不要new新对象
    }
    // 正常保存、跳转逻辑
    return RedirectToAction(nameof(Confirmation));
}

排查命名冲突
在控制器所有和Create动作相关的代码里，搜索是否存在ViewBag.AppDateOfBirth、ViewBag.AppTotalPersonsOccupy这类和模型属性同名的ViewBag/ViewData赋值，如果有就改名，避免空的ViewBag值覆盖模型值。
检查自定义验证逻辑
打开你实现的CheckBoxRequired自定义验证特性，确认逻辑里没有批量操作ModelState、误删/覆盖这两个字段对应条目的代码。

快速定位技巧：验证失败回发后，右键查看页面源码，看两个输入框的value属性是否有值：如果value有正确内容但页面显示空，就是格式和输入控件类型不匹配；如果value本身为空，就是取值优先级冲突、模型传值错误的问题。

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