c# - 如何禁用特定 ASP.NET Core 5.0 Web API 操作的自动模型绑定(bind)？

Question

我有一个第三方专有应用程序，我需要在我的 ASP.NET Core 5.0 Web API 应用程序中编写一个 API 端点。
第三方应用程序发出一个 HTTP post 请求，请求正文中只有二进制数据，内容类型为 application/x-www-form-urlencoded。或者，有时，application/octet-stream (有点随机，但数据是一样的)。
我的 Action 处理程序如下所示:

[Route("~/Validation")]
[ApiController]
public class ValidationController : ControllerBase
{
    [HttpPost("{requestId}")]
    [Consumes(@"application/octet-stream", @"application/x-www-form-urlencoded")]
    [Produces(@"application/octet-stream")]
    public async Task<IActionResult> Validation_Post([FromRoute] string requestId)
    {
        byte[] rawRequestBody = Array.Empty<byte>();
        {
            long streamInitialPos = 0;
            if (Request.Body.CanSeek) // rewind for this read.
            {
                streamInitialPos = Request.Body.Position;
                Request.Body.Seek(0, SeekOrigin.Begin);
            }
            using (var ms = new MemoryStream())
            {
                await Request.Body.CopyToAsync(ms);
                rawRequestBody = ms.ToArray() ?? throw new NullReferenceException();
            }
            if (Request.Body.CanSeek) // rewind to initial position.
                Request.Body.Seek(streamInitialPos, SeekOrigin.Begin);
        }

        // TODO: Handle rawRequestBody data.

        return new FileContentResult(new byte[] { 1 }, @"application/octet-stream")
        {
            EnableRangeProcessing = true,
            LastModified = DateTime.UtcNow
        };
    }

当第三方应用程序将其 HTTP 发布请求发送到我的 API 端点时，我的 API 应用程序崩溃并显示 System.ArgumentException :

Microsoft.AspNetCore.Server.IIS.Core.IISHttpServer: Error: Connection ID "18374686481282236432", Request ID "80000011-0000-ff00-b63f-84710c7967bb": An unhandled exception was thrown by the application.

System.ArgumentException: The key '[omitted binary data]' is invalid JQuery syntax because it is missing a closing bracket. (Parameter 'key')
   at Microsoft.AspNetCore.Mvc.ModelBinding.JQueryKeyValuePairNormalizer.NormalizeJQueryToMvc(StringBuilder builder, String key)
   at Microsoft.AspNetCore.Mvc.ModelBinding.JQueryKeyValuePairNormalizer.GetValues(IEnumerable`1 originalValues, Int32 valueCount)
   at Microsoft.AspNetCore.Mvc.ModelBinding.JQueryFormValueProviderFactory.AddValueProviderAsync(ValueProviderFactoryContext context)
   at Microsoft.AspNetCore.Mvc.ModelBinding.CompositeValueProvider.CreateAsync(ActionContext actionContext, IList`1 factories)
   at Microsoft.AspNetCore.Mvc.ModelBinding.CompositeValueProvider.TryCreateAsync(ActionContext actionContext, IList`1 factories)
   at Microsoft.AspNetCore.Mvc.Controllers.ControllerBinderDelegateProvider.<>c__DisplayClass0_0.<<CreateBinderDelegate>g__Bind|0>d.MoveNext()
--- End of stack trace from previous location ---
   at Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker.<InvokeInnerFilterAsync>g__Awaited|13_0(ControllerActionInvoker invoker, Task lastTask, State next, Scope scope, Object state, Boolean isCompleted)
   at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.<InvokeNextResourceFilter>g__Awaited|24_0(ResourceInvoker invoker, Task lastTask, State next, Scope scope, Object state, Boolean isCompleted)
   at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.Rethrow(ResourceExecutedContextSealed context)
   at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.Next(State& next, Scope& scope, Object& state, Boolean& isCompleted)
   at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.InvokeFilterPipelineAsync()
--- End of stack trace from previous location ---
   at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.<InvokeAsync>g__Logged|17_1(ResourceInvoker invoker)
   at Microsoft.AspNetCore.Routing.EndpointMiddleware.<Invoke>g__AwaitRequestTask|6_0(Endpoint endpoint, Task requestTask, ILogger logger)
   at Microsoft.AspNetCore.Server.IIS.Core.IISHttpContextOfT`1.ProcessRequestAsync()

Microsoft.AspNetCore.Hosting.Diagnostics: Information: Request finished HTTP/1.1 POST http://localhost:10891/validation/dummy application/x-www-form-urlencoded 11072 - 500 - - 164.0024ms

日志显示正在使用正确的路由操作。
如何仅为此特定操作处理程序禁用自动模型绑定(bind)？
提醒:我无法对第三方应用程序进行任何更改。我必须处理我收到的东西。我知道请求内容类型错误。请不要在这方面做任何笔记。

编辑:我已经找到了这个错误的表面原因。当我删除 [FromRoute] string requestId从函数签名来看，不会发生错误。当我重新引入它时，错误再次发生。
不起作用(导致 ASP.NET Core 内部异常):

public async Task<IActionResult> Validation_Post([FromRoute] string requestId)

是否有效:

public async Task<IActionResult> Validation_Post()

但是，我需要通过 Request.RouteValues["requestId"] 访问路由变量.
无论如何，问题仍然存在:
如何仅为此特定操作处理程序禁用自动模型绑定(bind)？

Answer 1

我认为您实际上已经找到了解决方案——或者，至少，确定了所有关键组件。请允许我遍历它们，以便您可以将它们组合成一个解决方案。
禁用模型绑定(bind)
模型绑定(bind)仅在您的操作有参数时发生 - 否则没有模型可绑定(bind)。这可能是一个实际模型，例如 POCO，或者只是一个值类型，例如您在此处拥有的字符串参数；相同的基本过程适用于两者。这就是为什么您在删除参数时不会收到错误消息的原因，也是您已经有效回答问题的原因。
在没有模型绑定(bind)的情况下提取路由值
拥有参数的唯一目的或好处是让它参与模型绑定(bind)。因此，如果您想禁用模型绑定(bind)，则没有理由维护该参数。没有它，您仍然可以使用 Request用于提取请求值的属性，包括表单字段、查询字符串参数、路由变量、请求 header 等。因此，在这种情况下，您仍然可以调用例如 Request.RouteValues["requestId"]正如你所指出的，在你的行动中。直接拨打RouteValueDictionary不会触发对 JQueryKeyValuePairNormalizer 的调用类，因此您不会遇到相同的异常。
潜在的路线模糊
也就是说，根据你的路由和路由参数的定义方式，你可能会遇到问题，例如，如果你依赖这个参数来消除你 Action 的其他重载之间的歧义，所以这是值得注意的。
根本问题
然而，要返回核心错误，我还建议您评估失败请求的请求数据，以确保没有任何内容可能与包含格式错误的索引器的字段名称混淆。根据您的描述，我不希望是这种情况，除非它以某种方式尝试将二进制数据解析为表单数据所需的键/值对，这可能是由于内容类型错误。无论如何，the line of code that’s throwing the error具体来说，当存在包含 [ 的字段时发生没有相应的 ] .例如，它应该与以下查询字符串一起出现:

?key[0=5

如果这样的事情是您传入请求的一致固定装置，那可能是罪魁祸首。显然，您无法对此做任何事情，因为您无法控制客户端，但将其隔离是很有用的，这样您就可以为 future 的实现提供指导。