MVC表单中单选按钮值无法传递至Action的问题排查

看起来你遇到了表单单选按钮和后端Action参数绑定的问题，我来帮你梳理几个最可能的原因和解决办法：

核心问题点分析 #

单选按钮要成功传递值到后端，关键要满足三个条件：name属性和后端参数名匹配、value值格式符合后端接收要求、每组至少有一个选项被选中。

1. 单选按钮的name必须与Action参数名完全匹配 #

后端Action的参数名（不管是单个参数还是ViewModel的属性名）要和单选按钮的name属性一一对应，大小写尽量保持一致（虽然部分框架支持大小写不敏感，但统一能避免很多坑）。

举个例子，如果你的Action是这样的：

[HttpPost]
public IActionResult RestaurantsSort(bool isSortByName, bool isAscending)
{
    // 排序逻辑
    return View();
}

那你的单选按钮name必须是isSortByName和isAscending，不能写错字或者大小写不一致。

2. 布尔值的value格式要正确 #

后端接收布尔参数时，需要单选按钮的value是"true"或"false"（字符串形式，小写或大写都可以，框架会自动转换）。别用"名称"/"评分"这种文本值，后端无法自动转换成布尔值，就会使用默认的false。

3. 每组单选按钮必须设置默认选中项 #

如果用户没有手动选择任何选项，表单提交时不会传递该组的参数，后端就会使用布尔类型的默认值false。所以一定要给每组单选按钮加一个checked属性，指定默认选中项。

正确的代码示例 #

结合以上几点，你的表单应该改成这样：

<form action="../Restaurant/RestaurantsSort" method="post" class="btn-group" style="margin-top: 10px;">
    <!-- 第一组：名称/评分 -->
    <div class="form-check">
        <input class="form-check-input" type="radio" name="isSortByName" id="sortByName" value="true" checked>
        <label class="form-check-label" for="sortByName">按名称排序</label>
    </div>
    <div class="form-check">
        <input class="form-check-input" type="radio" name="isSortByName" id="sortByRating" value="false">
        <label class="form-check-label" for="sortByRating">按评分排序</label>
    </div>

    <!-- 第二组：升序/降序 -->
    <div class="form-check">
        <input class="form-check-input" type="radio" name="isAscending" id="sortAsc" value="true" checked>
        <label class="form-check-label" for="sortAsc">升序</label>
    </div>
    <div class="form-check">
        <input class="form-check-input" type="radio" name="isAscending" id="sortDesc" value="false">
        <label class="form-check-label" for="sortDesc">降序</label>
    </div>

    <button type="submit" class="btn btn-primary">排序</button>
</form>

额外排查技巧 #

如果还是不行，打开浏览器的开发者工具（F12），切换到Network标签，提交表单后查看POST请求的Form Data部分，看看这两个参数有没有被传递，值是什么。如果参数没出现，说明单选按钮的name写错了或者没有选中项；如果值不对，就检查value的格式。

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