ASP.NET Core Minimal API自定义查询字符串参数绑定失败求助

兄弟我太懂你卡一整天最后求助StackOverflow的崩溃感了！咱们来一步步揪出问题所在：

你遇到的Required parameter "ListUserRequest request" was not provided错误，核心原因是Minimal API没识别到你写的TryParse方法——它根本不知道该怎么把查询字符串转换成你的ListUserRequest实例，所以默认认为这个参数是必填的，但又找不到对应的绑定值，直接报错了。

问题出在TryParse的签名上！ #

Minimal API对于自定义类型的查询字符串绑定，要求TryParse必须遵循.NET标准的签名格式，你现在写的TryParse(string? qs, out ListUserRequest request)不符合要求，框架压根不会调用它。

正确的解决方案： #

把你的TryParse方法改成下面的签名，同时完善内部逻辑：

public static bool TryParse(string? qs, IFormatProvider? provider, out ListUserRequest request)
{
    // 先初始化默认实例，避免返回null
    request = new ListUserRequest
    {
        ListParams = new ListQueryParameters() // 提前初始化嵌套类，防止空引用
    };

    // 如果查询字符串为空，直接返回默认实例即可
    if (string.IsNullOrWhiteSpace(qs))
    {
        return true;
    }

    var queryString = QueryHelpers.ParseQuery(qs);

    // 解析SearchPhrase
    if (queryString.TryGetValue(QueryStringParameterNames.SearchPhrase, out StringValues searchPhrase))
    {
        request.SearchPhrase = searchPhrase.ToString();
    }

    // 解析Page参数，用int.TryParse替代Convert，避免非法值抛异常
    if (queryString.TryGetValue(QueryStringParameterNames.ListQueryParameters.Page, out StringValues pageStr)
        && int.TryParse(pageStr.ToString(), out int pageNum))
    {
        request.ListParams.Page = pageNum;
    }

    // 继续添加其他参数的解析逻辑（比如pageSize、includeUnactive等）
    // ...

    // 只要能生成有效实例就返回true，参数验证可以后续在业务逻辑里做
    return true;
}

额外注意事项： #

1. 嵌套类的处理：你的ListQueryParameters如果也需要绑定查询参数，要么在ListUserRequest的TryParse里手动解析它的所有属性（就像上面的Page参数），要么给ListQueryParameters也实现符合要求的TryParse方法。
2. 参数命名要匹配：请求URL里的参数名要和你TryParse里取的键一致，比如要传递Page参数，URL应该是/get-users?ListParams.Page=1&SearchPhrase=admin这样的格式。
3. 避免强制转换：用int.TryParse代替Convert.ToInt32，遇到非法参数值时不会直接抛异常，而是保留默认值，更符合API的容错性。

改完之后再测试一下，不管是不带参数的请求，还是带查询参数的请求，应该都能正确绑定到ListUserRequest实例了！

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