swagger实战踩坑1
1.swagger error 有详细的错误信息
- 自己根据详细信息找问题
2.swagger error 无详细的错误信息
- Controller是否重名=》重名,指定不同的 [Route("*****")]
- Controller必须制定 [HttpPost] 或者 [HttpGet]
3.swagger无注释
- 引用项目,依次执行如下操作
- 项目=》属性=》生成:输出:XML文档文件,指定至固定目录
- webapi项目,添加链接文件(上一步的xml文件)
- 链接文件,依次执行如下操作
- 属性=》生成=》始终复制
- Startup.cs中的 ConfigureServices(IServiceCollection services)中,添加如下代码:
1 2 3 4 5 6 7 8 9 | services.AddSwaggerGen(c => { c.SwaggerDoc( "v1" , new Info { Title = "Platform.Service.Enterprise.WebApi API" , Version = "v1.0.0.0" }); c.DescribeAllEnumsAsStrings(); var basePath = PlatformServices.Default.Application.ApplicationBasePath; var docPath = Path.Combine(basePath, "Docs" ); var docs = XMLUtil.CreateXPathDocumentsFromDirectory(docPath); docs.ForEach(xp => c.IncludeXmlComments(() => { return xp; })); }); |
- Startup.cs中的 Configure(IApplicationBuilder app, IHostingEnvironment env)中,添加如下代码:
1 2 3 4 5 6 7 | app.UseSwagger(); // Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.), specifying the Swagger JSON endpoint. app.UseSwaggerUI(c => { c.SwaggerEndpoint( "/swagger/v1/swagger.json" , "Platform Enterprise WebApi API" ); }); |
- 重新生成解决方案
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步