ASP.NET Core WebApi 使用Swagger总结

1 官方文档

官方文档

2 错误分析

2.1 程序集xml文件不存在

2.1.1 现象

2.1.2 解决方案

在生成项目时没有生成对应XML,VS中右键属性-生成,勾XML文档文件并配置

配置后,程序正常启动

2.2 Swagger Failed to load API definition.

2.2.1 现象

2.2.2 解决方案

当你使用IIS Express 启动调试时,是不会有错误日志,所以你要切换到控制台启动

异常:System.NotSupportedException: Ambiguous HTTP method for action - CT.Service.AutoReplySupport.Api.Controllers.SelfCheckController.CheckDllFileTime (CT.Service.AutoReplySupport.Api). Actions require an explicit HttpMethod binding for Swagger 2.0

说明 你的Controller 有一个公共的方法没有指定HttpMethod特性,Swagger就生成json报错,添加特性就可以了 例如[httpGet];

posted @ 2020-01-03 17:16  RoinBi  阅读(269)  评论(0编辑  收藏  举报