使用openapi-spec-validator校验Swagger 2.0规范失败求助
排查openapi-spec-validator校验Swagger 2.0文件报错的问题
针对你遇到的'openapi' is a required property错误,结合Swagger 2.0和openapi-spec-validator的特性,排查方向如下:
检查Swagger 2.0标识字段是否正确
Swagger 2.0规范的根字段是swagger: "2.0"(注意版本号需以带双引号的字符串格式书写),如果你的abcd-spec.yaml未配置该字段,或误写为OpenAPI 3.x的openapi字段,工具会默认按OpenAPI 3规范校验,从而报错缺少openapi属性。排查文件YAML语法错误
若文件存在YAML语法问题(比如缩进错误、键值对格式不合法),会导致工具无法正确解析到swagger: "2.0"字段,进而误判为需要OpenAPI 3的openapi字段。可以先用yamllint abcd-spec.yaml这类命令检查文件语法是否合规。尝试显式指定校验规范版本
部分版本的openapi-spec-validator需要显式指定规范类型,你可以执行以下命令强制按Swagger 2.0校验:openapi-spec-validator --spec swagger_v2 abcd-spec.yaml
内容的提问来源于stack exchange,提问作者alex
相关产品推荐
相关产品推荐

