ASP.NET Core API中如何路由无键名查询字符串到控制器方法

你需要处理https://localhost:44355/?G3s2s这种无键查询字符串格式，将其中的G3s2s传递给RedirectShortURL方法的bitcode参数。默认模型绑定无法自动识别这种格式，因为它要求查询字符串键名与参数名匹配（比如?bitcode=G3s2s）。以下是可行的解决方案：

方法1：直接读取无键查询字符串值 #

修改控制器动作方法，从Request.Query中提取无键的查询值：

[Route("")]
public IActionResult RedirectShortURL()
{
    // 提取无键的查询字符串值（?G3s2s 会被解析为键为空的条目）
    var bitcodeEntry = Request.Query.FirstOrDefault(q => string.IsNullOrEmpty(q.Key));
    if (bitcodeEntry.Equals(default(KeyValuePair<string, StringValues>)) || string.IsNullOrEmpty(bitcodeEntry.Value))
    {
        return NotFound();
    }

    string bitcode = bitcodeEntry.Value;
    URL urlObj = _urlDAO.GetURLByBitcode(bitcode);

    return urlObj != null ? Redirect(urlObj.OriginalURL) : NotFound();
}

方法2：自定义模型绑定器（可选，适合复用场景） #

如果需要在多个地方复用这种绑定逻辑，可以创建自定义模型绑定器：

1. 创建绑定器类：

public class QueryStringWithoutKeyBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var queryEntry = bindingContext.HttpContext.Request.Query.FirstOrDefault(q => string.IsNullOrEmpty(q.Key));
        if (!queryEntry.Equals(default(KeyValuePair<string, StringValues>)))
        {
            bindingContext.Result = ModelBindingResult.Success(queryEntry.Value);
        }
        else
        {
            bindingContext.Result = ModelBindingResult.Failed();
        }
        return Task.CompletedTask;
    }
}

2. 创建绑定器提供类：

public class QueryStringWithoutKeyBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context.Metadata.ModelType == typeof(string))
        {
            return new QueryStringWithoutKeyBinder();
        }
        return null;
    }
}

3. 在Startup中注册绑定器：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers(options =>
    {
        options.ModelBinderProviders.Insert(0, new QueryStringWithoutKeyBinderProvider());
    });
}

4. 在动作方法参数上标记绑定：

[Route("")]
public IActionResult RedirectShortURL([ModelBinder(typeof(QueryStringWithoutKeyBinder))] string bitcode)
{
    if (string.IsNullOrEmpty(bitcode))
    {
        return NotFound();
    }

    URL urlObj = _urlDAO.GetURLByBitcode(bitcode);
    return urlObj != null ? Redirect(urlObj.OriginalURL) : NotFound();
}

关于路由配置的说明 #

你当前的路由配置中，{bitcode}是路径参数，匹配的是https://localhost:44355/G3s2s这种格式，而非/?G3s2s。如果你的需求就是查询字符串格式，不需要修改现有路由，保持控制器上的[Route("")]即可，它会匹配根路径的请求。

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