Question

我和Swagger Schema error should NOT have additional properties有类似的错误，但在我的情况下，我引用了＃/ definitions，所以我很感激一些帮助。

我尝试制作一个明确的对象：

    responses:
          '200':
            content: application/json
            schema:
              type: object
              properties:
                id: integer

这给了我：
路径['/ user']上的模式错误.post.responses ['200'] 不应该有其他属性 additionalProperty：内容，架构跳转到第119行

我也尝试过：

          responses:
          '200':
            $ref: '#/definitions/UserCreateResponse'

然后我得到了：
paths./user.post.responses.200.$ref中的语义错误 200 $ refs无法满足以下任何条件：“＃/ definitions ”，“＃/ parameters ” 跳到第120行

如果我使用$ ref，该对象会显示，但错误仍然存在于编辑器中。

Answer 1

您的第一个示例无效。将其更改为：

    produces:
      - application/json  # <-- Response Content-Type is specified by "produces"
    responses:
      '200':
        description: OK   # <-- Each response code needs a "description"
        schema:
          type: object
          properties:
            id:
              type: integer  # <---

很难说是什么导致了第二次错误（使用$ref时），因为您没有发布完整的规范。

Answer 2

@Stijn向我指出了修复：编写代码，然后从中生成Swagger代码。

此外，使用在线编辑器（从此处链接：https://swagger.io/swagger-editor/）而不是我本地的Dockerized版本也解决了这个问题。

尝试使用时Swagger架构错误

2 个答案: