.NET 8 Minimal API中可空int?参数无法接受空查询参数的问题

嘿，我完全懂你碰到的这个问题——这其实是.NET模型绑定的默认行为差异搞的鬼。

先给你捋清楚原因：当你传ServcoNo=这种空字符串的查询参数时，模型绑定器会尝试把这个空字符串转换成int?类型，但默认情况下它没办法完成这个转换，所以直接返回400错误；而string?类型本身就允许空字符串作为合法取值，绑定器自然能正常处理。

下面给你几个实用的解决方案，你可以根据自己的场景选：

方案1：全局配置所有可空值类型的绑定规则 #

如果你希望整个项目里的所有可空值类型（比如int?、long?）都能接受空字符串并自动转为null，可以在Program.cs里添加全局配置：

builder.Services.Configure<MvcOptions>(options =>
{
    options.ModelMetadataDetailsProviders.Add(new DisplayMetadataProvider(
        context =>
        {
            // 判断当前类型是可空值类型
            if (context.Key.ModelType.IsGenericType && 
                context.Key.ModelType.GetGenericTypeDefinition() == typeof(Nullable<>))
            {
                // 开启将空字符串转换为null的设置
                context.DisplayMetadata.ConvertEmptyStringToNull = true;
            }
        }));
});

配置完之后，所有可空值类型遇到空字符串的查询参数时，都会自动转为null，不会再返回400错误了。

方案2：针对单个参数手动处理（简单灵活） #

如果你只想处理这个特定的接口参数，最简单的方式是把参数类型改成string?，然后在方法内部手动转换成int?，还能自己处理解析失败的情况：

Route.MapGet("/SearchForServiceCompany", 
             (IMapper _mapper, string? ServcoNo, string? Name) =>
{
    // 把空字符串或无效数字转为null
    int? servcoNo = string.IsNullOrWhiteSpace(ServcoNo) 
        ? null 
        : int.TryParse(ServcoNo, out var num) ? num : null;
    
    // 接下来用servcoNo进行业务逻辑处理
} 

这种方式不需要改全局配置，也不用写复杂的绑定器，非常灵活。

方案3：自定义模型绑定器（适合复杂场景） #

如果你的项目里有很多地方需要这种处理，或者需要更复杂的解析逻辑，可以自定义一个针对int?的模型绑定器：

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

        if (string.IsNullOrWhiteSpace(value))
        {
            // 空字符串直接绑定为null
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        if (int.TryParse(value, out var result))
        {
            bindingContext.Result = ModelBindingResult.Success(result);
        }
        else
        {
            // 解析失败时添加错误信息
            bindingContext.ModelState.TryAddModelError(
                bindingContext.ModelName, 
                "请输入有效的数字格式");
        }

        return Task.CompletedTask;
    }
}

然后在接口参数上应用这个绑定器：

Route.MapGet("/SearchForServiceCompany", 
             (IMapper _mapper, [ModelBinder(typeof(NullableIntModelBinder))] int? ServcoNo, string? Name) =>
{
    // code
} 

最后再提一句，你说的string?参数能正常工作，是因为字符串类型本身就把空字符串当作合法值，模型绑定器不需要做任何转换，所以不会触发错误。

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