Swagger UI 无法解析定义中的 $ref

Question

我的 swagger 文件如下所示：

路径： /订单创建：

post:
  parameters:
    - name: OrderCreateRQ
      in: body
      description: The OrderCreateRQ request body
      required: true
      schema:
        $ref: '#/definitions/OrderCreateRQ'
  responses:
    200:
      description: Success response
      schema:
        $ref: '#/definitions/OrderCreateRS'

definitions:
  OrderCreateRQ:
    $ref: './common/OrderCreateRQ.schema'

  OrderCreateRS:
    $ref: './common/OrderCreateRS.schema'

我确实将“common”文件夹中的模式作为有效的 JSON 文件。

当我在 SwaggerUI 2.1.4 上启动它时，它说：

./common/OrderCreateRQ.schema is not defined!
./common/OrderCreateRS.schema is not defined!

我已尝试将架构文件移动到同一目录并进行引用，但失败了。 我在这里想念什么？有人可以帮我吗？

Answer 1

看起来这是一个 SwaggerUI 问题。我采用了最新版本 v2.2.6 并且相同的代码可以工作。