处理路径时 Swagger NPE

Question

我有一个非常简单的 OpenAPI/Swagger 配置 (openapi.yaml):

swagger: '2.0'
info:
  title: My Service
  version: 1.0
  description: A description for My Service
basePath: /my-service
schemes:
  - https
produces:
  - application/json

我配置了 Maven Swagger Codegen 插件。运行时，

> mvn clean install

我收到以下错误:

java.lang.NullPointerException
  at io.swagger.codegen.DefaultGenerator.processPaths (DefaultGenerator.java:806)
  at io.swagger.codegen.DefaultGenerator.generateApis (DefaultGenerator.java:431)
  at io.swagger.codegen.DefaultGenerator.generate (DefaultGenerator.java:746)
  ...

Answer 1

问题是 paths 字段是必需的。即使您不希望包含任何路径，也必须使用空对象指定它:

paths: {}

将 openapi.yaml 更新为以下内容将消除所描述的 NPE:

swagger: '2.0'
info:
  title: My Service
  version: 1.0
  description: A description for My Service
basePath: /my-service
schemes:
  - https
produces:
  - application/json
paths: {}