ASP.NET Web API(.NET7)自定义模型验证：区分创建与更新场景

问题场景 #

在.NET7的ASP.NET Web API项目中，存在如下数据模型：

public class MeetupGroup 
{
  public string GroupName { get; set; }
  public string MeetingPlace { get; set; }
  public ICollection<GroupMember> GroupMembers { get; set; }
}

public class GroupMember
{
  public string Email { get; set; }
  public string Name { get; set; }
}

要求创建MeetupGroup时必须至少包含一名成员，但HTTP PATCH更新场景仅需修改GroupName和MeetingPlace，无需验证成员存在。当前编写的自定义验证属性仅适用于POST场景，希望通过自定义属性实现场景区分，而非在控制器中处理验证逻辑。

另外，你当前的MembersNotEmptyAttribute存在类型转换错误：代码中将value强制转换为GroupMember，但实际传入的是ICollection<GroupMember>，运行时会抛出类型转换异常，需要先修正这个问题。

实现方案 #

无需在控制器中硬编码验证逻辑，以下两种方案均可通过自定义属性或DTO区分场景实现需求：

方案一：自定义验证属性结合请求方法判断 #

修改自定义验证属性，通过ValidationContext获取当前请求的HTTP方法，仅在POST请求时执行成员非空验证：

public class MembersNotEmptyAttribute : ValidationAttribute
{
    protected override ValidationResult? IsValid(object? value, ValidationContext validationContext)
    {
        // 获取HttpContext以判断请求方法
        if (validationContext.GetService(typeof(IHttpContextAccessor)) is IHttpContextAccessor httpContextAccessor)
        {
            var requestMethod = httpContextAccessor.HttpContext?.Request.Method;
            // 非POST请求直接通过验证
            if (requestMethod != HttpMethod.Post.Method)
            {
                return ValidationResult.Success;
            }
        }

        // 验证成员集合是否非空
        var members = value as ICollection<GroupMember>;
        if (members == null || !members.Any())
        {
            return new ValidationResult("必须至少包含一名成员");
        }

        return ValidationResult.Success;
    }
}

注意：需要在Program.cs中注册IHttpContextAccessor服务：

builder.Services.AddHttpContextAccessor();

之后直接在MeetupGroup的GroupMembers属性上应用该属性即可：

public class MeetupGroup 
{
  public string GroupName { get; set; }
  public string MeetingPlace { get; set; }
  
  [MembersNotEmpty]
  public ICollection<GroupMember> GroupMembers { get; set; }
}

方案二：使用不同的DTO模型（推荐） #

为创建和更新场景分别定义专用的DTO（数据传输对象），仅在创建DTO上应用验证属性，从根源上避免验证规则冲突：

创建DTO（用于POST请求）

public class CreateMeetupGroupDto
{
    public string GroupName { get; set; }
    public string MeetingPlace { get; set; }
    
    [MembersNotEmpty]
    public ICollection<GroupMember> GroupMembers { get; set; }
}

更新DTO（用于PATCH请求）

public class UpdateMeetupGroupDto
{
    public string GroupName { get; set; }
    public string MeetingPlace { get; set; }
    // 可根据需求选择是否保留GroupMembers属性，无需验证
    public ICollection<GroupMember>? GroupMembers { get; set; }
}

控制器中使用对应DTO

[ApiController]
[Route("api/meetupgroups")]
public class MeetupGroupsController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CreateMeetupGroupDto createDto)
    {
        // 处理创建逻辑，将DTO转换为实体
        var meetupGroup = new MeetupGroup
        {
            GroupName = createDto.GroupName,
            MeetingPlace = createDto.MeetingPlace,
            GroupMembers = createDto.GroupMembers
        };
        // 后续存储逻辑...
        return Ok();
    }

    [HttpPatch("{id}")]
    public IActionResult Update(int id, [FromBody] UpdateMeetupGroupDto updateDto)
    {
        // 处理更新逻辑，仅更新需要修改的字段
        // 后续存储逻辑...
        return Ok();
    }
}

这种方案符合单一职责原则，代码更清晰易维护，也避免了同一个模型在不同场景下的验证规则冲突。

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