如何解决ASP.NET Core 9 Minimal API中强类型ID结构体的模型绑定问题？

我太懂你这种卡壳的感觉了——用Andrew Lock的StronglyTypedId包生成的强类型ID，明明包已经帮你生成了TypeConverter和JsonConverter，结果在Minimal API接收表单数据时就是绑定不上，折腾几个小时没头绪确实闹心。我来给你捋几个靠谱的解决思路，亲测有效的那种：

• 先把基础配置和检查做扎实
  首先确认下你的.csproj里有没有开启TypeConverter的生成开关，有时候默认可能没开：

  <PropertyGroup>
      <StronglyTypedIdGenerateTypeConverter>true</StronglyTypedIdGenerateTypeConverter>
      <StronglyTypedIdGenerateJsonConverter>true</StronglyTypedIdGenerateJsonConverter>
  </PropertyGroup>
  

  然后检查两个关键点：一是你的端点参数有没有加[FromForm]特性（Minimal API不会自动识别表单源，必须明确指定）；二是表单里的字段名和模型里强类型ID的属性名完全匹配，大小写也要注意，如果表单字段名不一样，记得用[FromForm(Name = "xxx")]手动映射，比如：

  public class OrderForm
  {
      [FromForm(Name = "order_id")]
      public OrderId OrderId { get; set; }
      // 其他表单属性
  }
  

• 手动注册TypeConverter到模型绑定系统
  有时候Minimal API的模型绑定系统不会自动发现生成的TypeConverter，这时候咱们手动把它注册进去就行。在Program.cs里加这么一段代码：

  using System.ComponentModel;
  
  // 替换成你自己的强类型ID和对应的转换器类名
  TypeDescriptor.AddAttributes(typeof(OrderId), new TypeConverterAttribute(typeof(OrderIdTypeConverter)));
  

  这段代码会告诉系统，处理OrderId类型的时候用对应的TypeConverter来转换表单字符串。

• 自定义模型绑定器兜底
  如果上面的方法都不管用，那咱们就写个专门的模型绑定器，直接接管强类型ID的绑定逻辑。
  首先写绑定器类：

  public class StronglyTypedIdBinder<TId> : IModelBinder where TId : struct, IStronglyTypedId
  {
      public Task BindModelAsync(ModelBindingContext bindingContext)
      {
          if (bindingContext == null)
              throw new ArgumentNullException(nameof(bindingContext));
  
          var valueResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
          if (valueResult == ValueProviderResult.None)
              return Task.CompletedTask;
  
          bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueResult);
          var rawValue = valueResult.FirstValue;
  
          if (string.IsNullOrWhiteSpace(rawValue))
              return Task.CompletedTask;
  
          // 用StronglyTypedId包生成的TryParse方法转换
          if (TId.TryParse(rawValue, out var typedId))
          {
              bindingContext.Result = ModelBindingResult.Success(typedId);
          }
          else
          {
              bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, $"无效的{typeof(TId).Name}格式");
          }
  
          return Task.CompletedTask;
      }
  }
  

  再写一个绑定器提供者，让系统识别所有强类型ID：

  public class StronglyTypedIdBinderProvider : IModelBinderProvider
  {
      public IModelBinder? GetBinder(ModelBinderProviderContext context)
      {
          if (context == null)
              throw new ArgumentNullException(nameof(context));
  
          // 判断是否是强类型ID结构体
          if (context.Metadata.ModelType.IsValueType && 
              typeof(IStronglyTypedId).IsAssignableFrom(context.Metadata.ModelType))
          {
              var binderType = typeof(StronglyTypedIdBinder<>).MakeGenericType(context.Metadata.ModelType);
              return (IModelBinder)Activator.CreateInstance(binderType)!;
          }
  
          return null;
      }
  }
  

  最后在Program.cs里注册这个提供者：

  builder.Services.AddControllers(options =>
  {
      // 把自定义提供者放到最前面，优先使用
      options.ModelBinderProviders.Insert(0, new StronglyTypedIdBinderProvider());
  });
  

  要是不想全局注册，也可以直接在端点参数上指定绑定器：

  app.MapPost("/create-order", ([FromForm, ModelBinder(typeof(StronglyTypedIdBinder<OrderId>))] OrderId orderId) =>
  {
      // 业务逻辑
      return Results.Ok();
  });
  

一般来说，按这个顺序排查下来，问题就能解决了。先从基础配置查起，再到注册转换器，最后用自定义绑定器兜底，总能搞定的。

备注：内容来源于stack exchange，提问作者Gup3rSuR4c