为何可空List<Guid>字段选空值时出现‘值''无效’错误？

当你选择多选select里的空选项时，表单会提交空字符串""，但ASP.NET Core的模型绑定器无法将空字符串直接转换成List<Guid>?类型，因此触发了"The value '' is invalid"的验证错误。

方法一：控制器内手动处理绑定错误 #

直接在POST提交的Action里定位并清除错误，手动设置workers的有效值：

[HttpPost]
public IActionResult Edit(Project project)
{
    // 检查workers字段的绑定错误
    if (ModelState.TryGetValue("workers", out var state) && state.Errors.Any(e => e.ErrorMessage == "The value '' is invalid"))
    {
        // 根据业务需求设置为null或空列表
        project.workers = null;
        // 清除该字段的错误信息
        state.Errors.Clear();
        // 重新验证模型确保无其他问题
        TryValidateModel(project);
    }

    if (ModelState.IsValid)
    {
        _context.Update(project);
        _context.SaveChanges();
        return RedirectToAction(nameof(Index));
    }

    // 验证失败时返回编辑页面
    return View(project);
}

方法二：自定义模型绑定器（一劳永逸） #

如果多个页面都有类似的List<Guid>绑定需求，可以写一个自定义模型绑定器，自动处理空字符串的转换：

1. 创建绑定器和提供器类：

public class GuidListModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var rawValue = bindingContext.ValueProvider.GetValue(bindingContext.ModelName).FirstValue;

        if (string.IsNullOrEmpty(rawValue))
        {
            // 空字符串直接返回null
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        // 解析正常的Guid列表，自动过滤无效值
        var guidList = rawValue.Split(',')
                            .Where(s => Guid.TryParse(s, out _))
                            .Select(Guid.Parse)
                            .ToList();
        bindingContext.Result = ModelBindingResult.Success(guidList);
        return Task.CompletedTask;
    }
}

public class GuidListModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context.Metadata.ModelType == typeof(List<Guid>?) || context.Metadata.ModelType == typeof(List<Guid>))
        {
            return new GuidListModelBinder();
        }
        return null;
    }
}

2. 在Program.cs中注册绑定器：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllersWithViews(options =>
{
    // 将自定义绑定器放在最前面，优先使用
    options.ModelBinderProviders.Insert(0, new GuidListModelBinderProvider());
});

方法三：使用视图模型中转 #

创建专门用于表单提交的视图模型，用字符串类型接收workers值，再在控制器内转换为List<Guid>?：

1. 定义视图模型：

public class ProjectEditViewModel
{
    public Guid id { get; set; }
    // 复制Project类的其他字段
    // ...
    public string? workers { get; set; }
}

2. 修改视图绑定字段：

<select multiple asp-for="workers" asp-items=@ViewBag.workers>
    <option value="">--Select--</option>
</select>

3. 控制器内处理转换逻辑：

[HttpPost]
public IActionResult Edit(ProjectEditViewModel vm)
{
    var project = _context.Projects.Find(vm.id);
    if (project == null) return NotFound();

    // 转换workers字段
    if (string.IsNullOrEmpty(vm.workers))
    {
        project.workers = null;
    }
    else
    {
        project.workers = vm.workers.Split(',').Select(Guid.Parse).ToList();
    }

    // 映射其他字段到project实例
    // ...

    if (ModelState.IsValid)
    {
        _context.SaveChanges();
        return RedirectToAction(nameof(Index));
    }

    // 验证失败时返回编辑页面
    return View(vm);
}

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