openapi - 将OpenAPI Generator与OpenAPI 3.0一起使用时， "Unrecognized token openapi"错误是什么意思？

Question

我已经以OpenAPI 3.0格式(https://swagger.io/docs/specification/basic-structure/)编写了API定义。现在，我试图像以前使用Swagger 2.0定义及其关联的Maven插件一样来生成Java Spring对象。

到目前为止，我有一个基本的API定义，开头是:
openapi: 3.0.0
info:
title: Demo API
description: This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification).
version: 0.0.1
在我的pom.xml文件中，我添加了:

<dependency>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-cli</artifactId>
  <version>3.3.3</version>
</dependency>

但是当执行 mvn install时，出现此错误:

com.fasterxml.jackson.core.JsonParseException: Unrecognized
     token 'openapi': was expecting ('true', 'false' or 'null')
     at [Source: definition\DEFINITION.yml; line: 1, column: 9]

有人知道问题出在哪里吗？

Answer 1

我目前正在使用openapi-generator-maven-plugin从OpenAPI JSON模式生成Java类。

错误看起来像语法问题。因此，首先请确保您的架构在语法上是正确的，并且看起来像这样:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo API",
    "description": "This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification).",
    "version": "0.0.1"
  },
  # Schema definition goes here
}