不允许附加属性：nullable swagger

Question

我使用的是与node.js快递4.12.3和mysql db招摇过市2.0。

我创建了以下模式-

  Country:
    type: "object"
    properties:
      id:
        type: "integer"
        readOnly: true
        description: "Country Id"
      country:
        type: "string"
        description: "Country name"
      created_at:
        type: "string"
        readOnly: true
        format: "date-time"
        description: "Country record creation date"
      deleted_at:
        type: "string"
        format: "date-time"
        description: "Country record delete date"
    required:
      - country

此处删除的_at字段将为空，并且在删除记录之前不会出现在数据库中。我的基于express的nodejs服务器返回的日期如下-

[{id:4，“国家”：“g”，“创建时间”：“2018-01-29T04:51:46.000Z”，“删除时间”：null}，{id:5，“国家”：“gaaaf”，“创建时间”：“2018-01-29T04:54:59.000Z”，“删除时间”：null}，{id:6，“国家”：“abcd”，“创建时间”：“2018-01-29T04:57:02.000Z”，“删除时间”：null}]

当我试图通过招摇过市的用户界面打Rest电话时，我得到以下错误-

"message":"Response validation failed: failed schema

validation","code":"SCHEMA_VALIDATION_FAILED","failedValidation":true,
{"errors":[{"code":"INVALID_TYPE","message":"Expected type string but found type null","path":["5","deleted_at"],"description":"Country record delete date"},

看完这些文件后，我做了如下工作-

  deleted_at:
    type: "string"
    format: "date-time"
    nullable: true
    description: "Country record delete date"

然后我开始在swagger ui中发现这个验证错误

消息："不允许其他属性：可空"

我试着从字符串中将type设置为object，但即使这样也不起作用。

 deleted_at:
        type: "object"
        format: "date-time"
        nullable: true
        description: "Country record delete date"

Answer 1

OpenAPI/Swagger 2.0不允许任何类型的值为空nullable:true是在OpenAPI 3.0中引入的，OpenAPI/Swagger 2.0不支持它。

解决方法是不发送deleted_at，如果它应该是null。