ASP.NET Core WebApi 使用Swagger总结

目录

• 1 官方文档
• 2 错误分析
  • 2.1 程序集xml文件不存在
    • 2.1.1 现象
    • 2.1.2 解决方案
  • 2.2 Swagger Failed to load API definition.
    • 2.2.1 现象
    • 2.2.2 解决方案

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];