ASP.NET Core MVC控制器用FormCollection收POST表单报500错误如何解决

• 控制器Action参数未添加[FromForm]特性：ASP.NET Core中FormCollection类型参数默认不会从表单请求体绑定数据，缺少该特性会导致参数绑定失败，触发服务端异常返回500。
• 未引入jQuery Unobtrusive Ajax依赖：表单中使用的data-ajax*系列属性依赖jquery.unobtrusive-ajax.min.js库，未引入时表单ajax提交逻辑不会生效，提交行为不符合预期。
• 缺少防伪验证标记：ASP.NET Core默认开启POST请求防伪验证，表单中未添加@Html.AntiForgeryToken()生成防伪字段时，请求会被验证拦截抛出异常。
• 表单提交逻辑未正确触发：按钮type为button不会默认触发表单提交，若CheckForm验证通过后未手动调用表单提交方法，或提交逻辑存在错误，也会导致请求异常。
• 表单内部控件未设置name属性：表单提交时只会携带设置了name属性的控件值，若所有控件都无name属性，可能导致表单参数为空触发绑定异常。
• 路由配置不匹配：asp-controller填写的控制器名需要和实际控制器类名（后缀为Controller）对应，asp-action填写的方法名也需要和后端方法名完全匹配，拼写错误会导致请求找不到对应接口报错。

• 给Action参数添加[FromForm]特性，修改后控制器代码如下：

[HttpPost]
public async Task<JsonResult> SaveIndexData([FromForm] FormCollection collection)
{
    // 返回json结果
    string result = "";
    // 业务逻辑代码
    return Json(result);
}

• 确认项目中已正确引入jQuery和jQuery Unobtrusive Ajax依赖库，且加载顺序为jQuery在前，Unobtrusive Ajax在后。
• 在<form>标签内部添加防伪标记：@Html.AntiForgeryToken()。
• 调整按钮提交逻辑，确保CheckForm函数验证通过后手动触发表单提交，示例逻辑：

function CheckForm(e) {
    // 自定义表单验证逻辑
    if (/* 验证通过条件 */) {
        document.getElementById('frm_Index').submit();
        // jQuery写法：$('#frm_Index').submit();
    } else {
        // 验证失败提示逻辑
    }
}

也可直接将按钮type改为submit，给表单添加onsubmit事件绑定验证逻辑，无需手动调用提交方法。

• 检查所有需要提交的表单控件，确保设置了正确的name属性，和后端从FormCollection取值的键名对应。
• 核对asp-controller和asp-action的拼写，比如控制器名为IndexController时asp-controller填写Index即可，方法名需和后端SaveIndexData完全一致。

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