ASP.NET Core中使用HierarchyId发送POST请求时HierarchyId值为空如何解决？

安全阿岳

2026-9-24

问题原因

字段名不匹配：你定义的Country模型中层级字段为parentId（HierarchyId类型），但视图中表单绑定的是hierarchyId，字段名不一致导致模型绑定失败。
提交值类型不匹配：下拉框当前提交的是父节点的int类型主键Id，而HierarchyId类型需要接收/1/、/1/2/这类标准格式的字符串才能正确解析，ASP.NET Core默认没有内置HierarchyId的类型转换器，无法直接将int值转为HierarchyId对象。
模型不一致：你业务场景定义的是Country模型，但视图代码中用的是Category类，需先确保前后端使用的实体字段完全统一。

修复方案

1. 基础修正

首先修正下拉框的字段名和提交值，将提交值改为父节点HierarchyId的字符串格式：

<div class="form-group">
    <label class="text-muted" asp-for="parentId"></label>
    <select class="form-control" asp-for="parentId" id="parentId">
        <option value="">顶级节点</option>
        @foreach (var item in ViewBag.AllCAT)
        {
            <option value="@item.hierarchyId.ToString()">@item.Name</option>
        }
    </select>
</div>

注意：这里把包裹下拉的form-control类换成form-group，避免样式冲突。

2. 快速适配（无需自定义绑定器）

在控制器的Create方法中手动接收字符串格式的层级ID，解析后赋值给模型：

[HttpPost]
public IActionResult Create(Country country, string parentId)
{
    if (!string.IsNullOrWhiteSpace(parentId))
    {
        country.parentId = HierarchyId.Parse(parentId);
    }
    // 后续保存逻辑
    // _context.Countries.Add(country);
    // _context.SaveChanges();
    return RedirectToAction(nameof(Index));
}

3. 全局适配（推荐）

如果多处用到HierarchyId，可以自定义模型绑定器实现全局自动转换：

定义绑定器

public class HierarchyIdBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueResult == ValueProviderResult.None || string.IsNullOrWhiteSpace(valueResult.FirstValue))
        {
            return Task.CompletedTask;
        }
        try
        {
            var hId = HierarchyId.Parse(valueResult.FirstValue);
            bindingContext.Result = ModelBindingResult.Success(hId);
        }
        catch
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "无效的层级格式");
        }
        return Task.CompletedTask;
    }
}

注册绑定器（Program.cs）

builder.Services.AddControllersWithViews(options =>
{
    options.ModelBinderProviders.Insert(0, new BinderTypeModelBinderProvider(typeof(HierarchyIdBinder)));
});

注册后就不需要在每个Action里手动解析，框架会自动把提交的字符串转为HierarchyId对象。

内容的提问来源于stack exchange，提问作者m-Esmaeil