OpenAPI规格：查询参数的默认值被忽略

Question

我已经将OpenAPI 3规格中的一个参数描述为

review_requests:
  get:
    tags:
      - dashboard
    operationId: reviewRequests
    parameters:
      - name: page
        in: query
        default: 0
        description: Page number
        schema:
          type: integer
    responses:
      200:
        description: OK

汇编之后，我看到Java代码中缺少默认值，并且该参数实际上被描述为：

@Valid @RequestParam(value = "page", required = false) Integer page

而不是 0 i接收 null 如果未在获取请求中提供参数。 据我所知，应该

@Valid @RequestParam(value = "page", required = false, defaultValue = "0") Integer page

是一个错误还是我做错了什么？

Answer 1

最后，我找到了解决方案：在 OpenAPI 3.x ，必须在参数的架构中指定默认值。换句话说，

    parameters:
      - name: page
        in: query
        default: 0
        description: Page number
        schema:
          type: integer

应该是

    parameters:
      - name: page
        in: query
        description: Page number
        schema:
          type: integer
          default: 0