OpenAPI规范说“应用程序/x-ww-form-urlencoded”，但生成的Spring boot需要多部分/form-data或多部分/混合流

Question

我试图使用现有Python演示中的OpenAPI规范来创建Java中的类似演示，并使用了带有OpenAPI生成器maven插件的“spring”生成器和以下配置选项：

                                <!-- generates single interface to implement -->
                                <useTags>true</useTags>

                                <withXml>true</withXml>
                                <title>${project.artifactId}</title>

                                <performBeanValidation>true</performBeanValidation>
                                <useBeanValidation>true</useBeanValidation>
                                <useOptional>true</useOptional>
                                <useSpringController>false</useSpringController>

                                <returnSuccessCode>false</returnSuccessCode>

                                <useAbstractionForFiles>true</useAbstractionForFiles>

                                <!-- Our own delegates can be autowired into the generated sources -->
                                <delegatePattern>true</delegatePattern>

下面是YAML片段：

post:
  description: Add products to shopping cart.
  operationId: api.cart.add_product

  requestBody:
    required: true
    content:
      'application/x-www-form-urlencoded':
        schema:
          type: object
          properties:
            quantity:
              type: integer
              example: 1
            product_code:
              type: string
              example: elephant
          required:
            - quantity
            - product_code
        examples:
          add_an_elephant:
            summary: How to add a single elephant to the shopping cart
            value:
              product_code: elephant
              quantity: 1
  
  responses:
    '204':
      description: Product added to cart.
    '400':
      description: Cannot add product to cart.
    '422':
      description: Unknown product code.

使用一点额外的胶水，让Spring自动连接请求变量，这将编译并启动。现在我的问题是，正如OpenAPI文件中所说，swagger页面生成了一个应用程序/x-www-form-urlencoded请求，但Tomcat在尝试调用时失败了：

    @RequestMapping(
        method = RequestMethod.POST,
        value = "/cart/add",
        consumes = { "application/x-www-form-urlencoded" }
    )
    default ResponseEntity<Void> apiCartAddProduct(
        @Parameter(name = "quantity", description = "", required = true, schema = @Schema(description = "")) @Valid @RequestPart(value = "quantity", required = true) Integer quantity,
        @Parameter(name = "product_code", description = "", required = true, schema = @Schema(description = "")) @Valid @RequestPart(value = "product_code", required = true) String productCode
    ) {
        return getDelegate().apiCartAddProduct(quantity, productCode);
    }

然后调用

    @Override
    public ResponseEntity<Void> apiCartAddProduct(Integer quantity, String productCode) {
        var product = products.stream().filter(p -> p.getCode().equals(productCode)).findFirst().get();
        CartEntry price = new CartEntry().product(product).price(product.getPrice()).quantity(quantity).price(product.getPrice() * quantity);
        cart.add(price);
        return new ResponseEntity<Void>((Void) null, HttpStatus.OK);
    }

除此之外：

org.apache.tomcat.util.http.fileupload.impl.InvalidContentTypeException: the request doesn't contain a multipart/form-data or multipart/mixed stream, content type header is application/x-www-form-urlencoded
    at org.apache.tomcat.util.http.fileupload.impl.FileItemIteratorImpl.init(FileItemIteratorImpl.java:151) ~[tomcat-embed-core-9.0.56.jar:9.0.56]
    at org.apache.tomcat.util.http.fileupload.impl.FileItemIteratorImpl.getMultiPartStream(FileItemIteratorImpl.java:205) ~[tomcat-embed-core-9.0.56.jar:9.0.56]

我的理解是，OpenAPI生成器应该生成可以接受YAML文件中声明的类型的代码，但可能有很多原因导致它不能接受。

我的问题是，我不明白为什么这是一个问题，以及它的原因。出了什么问题，我该如何解决？如果有可能避免更改openapi yaml文件，我宁愿这样做。

编辑：在Tomcat看到的apiCartAddProduct的定义中，似乎通过实验将@RequestPart更改为@RequestParam使其工作。由于这是更改自动生成的代码，我正在寻找更好的解决方案。建议？

Answer 1

看来这是故意闯入的https://github.com/OpenAPITools/openapi-generator/commit/a0eb149df5b722bfd43cf3587399c118850af76c（4.3版），类似于https://github.com/OpenAPITools/openapi-generator/issues/7794，然后固定在https://github.com/OpenAPITools/openapi-generator/commit/33b89148e562fc2d5acf60a56719c46ec4f631e8 (2022-02-27)

这意味着我使用的5.4.0版本并不是固定的，但6.0.0-beta版本是固定的。

升级到测试版修复了这个问题。