Azure Function中OpenApiParameter必填Header验证失效问题排查

[OpenApiParameter]特性仅用于生成OpenAPI规范文档，它不会自动为Azure Function添加请求校验逻辑。所以即使标记了Required = true，也只是在Swagger文档里显示该Header为必填，实际请求时不会强制校验。

• 手动校验Header存在性：在Function的代码逻辑开头，直接检查请求Header是否存在，不存在则返回400错误：

  public async Task<HttpResponseData> Run([HttpTrigger(AuthorizationLevel.Anonymous, HttpTriggerConstants.PostParamsMethod)] HttpRequestData request)
  {
      if (!request.Headers.TryGetValues(RequestHeaders.Reqheader, out _))
      {
          var badResponse = request.CreateResponse(HttpStatusCode.BadRequest);
          await badResponse.WriteStringAsync($"缺少必填Header: {RequestHeaders.Reqheader}");
          return badResponse;
      }
      // 后续业务逻辑
  }
  

• 使用自定义绑定或验证中间件：如果多个Function都需要类似校验，可以自定义一个绑定或者中间件，统一处理Header校验逻辑，避免重复代码。
• 结合API网关做校验：将Azure Function接入Azure API Management，导入生成的OpenAPI文档，由网关层负责请求校验，再转发到Function。

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