OpenAPI 3：缺少属性“$ref”

Question

我正在 VSCode 中使用 OpenAPI 3 编写一个 API 文档，扩展名为OpenAPI (Swagger) Editor v4.9.1。直到今天它都运行得很好 - 突然我的文档充满了所有模式声明中“属性”的错误。错误如下：

Missing property "$ref". yaml-schema: Validation schema for OpenAPI Specification 3.0.X.

显然，这个错误根本没有意义，因为根据 OpenAPI 规范，$ref 在任何地方都不是必填字段。
此外，我仍然可以使用 swagger 的默认渲染器预览该文档，或者使用其 CodeGen 工具链生成代码，这表明该文档没有实际错误。
那么发生了什么事？是 OpenAPI 语言服务器中的错误吗？

Answer 1

我今天开始面临同样的问题，更新你的 openapi 版本可能是一个临时解决方案。

openapi: "3.1.0"