ASP.NET Core MVC表单内自动添加额外复选框输入的问题求助

核心原因 #

ASP.NET Core MVC中，原生Checkbox/CheckboxFor会自动添加同名隐藏字段（值为false），目的是解决复选框未勾选时表单不提交任何值的问题。即使使用自定义Helper，若Helper内部依赖了原生的表单模型绑定逻辑，或者被ASP.NET Core的表单追踪机制识别，就会自动追加该字段。

可行解决方案 #

1. 完全手写原生HTML输入标签（最直接） #

绕过所有HtmlHelper和TagHelper，直接手动生成复选框，避免触发ASP.NET Core的自动追加逻辑：

<!-- 绑定模型属性 -->
<input type="checkbox" 
       id="CrossCompanyJobRangeActive" 
       name="CrossCompanyJobRangeActive" 
       value="true" 
       @(Model.CrossCompanyJobRangeActive ? "checked" : "") />
<label for="CrossCompanyJobRangeActive">跨公司职位范围启用</label>

这种写法完全脱离框架的自动生成逻辑，不会产生额外隐藏字段。

2. 重构自定义Html Helper，完全独立实现 #

如果必须使用Helper，确保自定义Helper完全手动构建输入标签，不调用任何原生Checkbox相关的生成方法：

using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.AspNetCore.Mvc.ViewFeatures;
using System.Linq.Expressions;

namespace YourProjectNamespace.Helpers
{
    public static class CustomHtmlHelpers
    {
        public static IHtmlContent CheckboxSimpleFor<TModel>(this IHtmlHelper<TModel> htmlHelper, Expression<Func<TModel, bool>> expression)
        {
            // 获取模型属性信息
            var modelExplorer = htmlHelper.ViewContext.ViewData.ModelExplorer.GetExplorerForExpression(expression);
            var propertyName = htmlHelper.NameFor(expression).ToString();
            var isChecked = modelExplorer.Model is bool checkedValue && checkedValue;

            // 手动构建input标签
            var inputTag = new TagBuilder("input");
            inputTag.MergeAttribute("type", "checkbox");
            inputTag.MergeAttribute("name", propertyName);
            inputTag.MergeAttribute("id", propertyName);
            inputTag.MergeAttribute("value", "true");
            
            if (isChecked)
            {
                inputTag.MergeAttribute("checked", "checked");
            }

            return inputTag;
        }
    }
}

在视图中引用后使用：

@using YourProjectNamespace.Helpers

@Html.CheckboxSimpleFor(m => m.CrossCompanyJobRangeActive)
<label for="CrossCompanyJobRangeActive">跨公司职位范围启用</label>

3. 禁用特定属性的模型绑定额外字段（不推荐，仅极端场景） #

如果需要保留框架其他自动行为，仅针对特定属性禁用额外字段，可以通过自定义模型绑定器实现，但复杂度较高，一般不推荐。

验证方法 #

添加后查看渲染的HTML源代码，确认<form>内仅存在单个目标复选框输入，无额外的同名隐藏字段，即可解决JS序列化错误问题。

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