swagger Unable to render this definition

Unable to render this definition

The provided definition does not specify a valid version field.

Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.0.n (for example, openapi: 3.0.0).

 

可能的原因:

1、api中的Controller/Action 请加入[HttpPost]或者 [HTTPGet]

2、api中的Controller中有私有方法（全部写道Service）

3、传入参数模型有问题.

访问链接：http://localhost:<port>/swagger/v1/swagger.json 查看生成的描述终结点的文档显示如下json格式，可排查部分错误。