Minimal API使用FromQuery绑定自定义类型时出现编译错误求助

问题原因 #

你遇到的错误源于.NET 7及后续版本的ASP.NET Core规则：使用[FromQuery]绑定复杂类型（如你的ProductSearchParameters record）时，框架要求该类型必须实现IParsable<T>接口，或定义TryParse静态方法。你参考的书籍可能基于更早版本的ASP.NET Core，当时的绑定逻辑允许直接用[FromQuery]绑定复杂类型。

解决方案 #

方案1：改用[AsParameters]属性（推荐） #

这是官方推荐的绑定复杂查询参数的方式，会自动将查询字符串中的参数映射到ProductSearchParameters的对应属性上，无需额外编写解析逻辑。

修改后的端点代码：

public static IEndpointRouteBuilder MapProductEndpoints(this IEndpointRouteBuilder app)
{
    var path = app.MapGroup("/api").WithTags("Products");

    path.MapGet("/products", async([AsParameters] ProductSearchParameters parameters, IProductService service, CancellationToken cancellationToken
    ) =>
    {
        var products = await service.SearchAsync(parameters, cancellationToken);

        return Results.Ok(products);
    });

    return app;
}

你的ProductSearchParameters record无需修改，保持原定义即可。

方案2：让ProductSearchParameters实现IParsable<T>接口 #

如果坚持使用[FromQuery]，可以让record实现IParsable<ProductSearchParameters>接口，自行编写解析逻辑：

修改后的ProductSearchParameters代码：

public record ProductSearchParameters
(
    string? SearchItem,
    int Page = 1,
    int PageSize = 20
) : IParsable<ProductSearchParameters>
{
    public static ProductSearchParameters Parse(string s, IFormatProvider? provider)
    {
        if (!TryParse(s, provider, out var result))
            throw new FormatException("无法解析查询参数");
        return result;
    }

    public static bool TryParse(string? s, IFormatProvider? provider, out ProductSearchParameters result)
    {
        string? searchItem = null;
        int page = 1;
        int pageSize = 20;

        if (!string.IsNullOrEmpty(s))
        {
            var parts = s.Split('&', StringSplitOptions.RemoveEmptyEntries);
            foreach (var part in parts)
            {
                var keyValue = part.Split('=', 2);
                if (keyValue.Length != 2) continue;

                var key = keyValue[0].ToLower();
                var value = Uri.UnescapeDataString(keyValue[1]);

                switch (key)
                {
                    case "searchitem":
                        searchItem = value;
                        break;
                    case "page":
                        int.TryParse(value, out page);
                        break;
                    case "pagesize":
                        int.TryParse(value, out pageSize);
                        break;
                }
            }
        }

        result = new ProductSearchParameters(searchItem, page, pageSize);
        return true;
    }
}

注意：这种方式需要手动处理查询字符串解析，相对繁琐，因此方案1是更简洁的选择。

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