swagger在 .net core中的使用:大佬步骤点击前往

在安装大佬的步骤来配置swagger后来配置,发现一些问题。特此总结下

安装包:Swashbuckle.AspNetCore

在Startup.cs 配置swagger

在ConfigureServices中添加代码

 //注册Swagger生成器,定义一个和多个Swagger 文档services.AddSwaggerGen(c => {c.SwaggerDoc("V1", new Info{Version = "V1",Title = "体检系统后台服务",Description = "这是一个基于.net core的web API",TermsOfService = "None",Contact = new Contact{Name = "姓名",Email = "邮箱",Url = "http://www.xx.com"},License = new License{Name = "许可证名字",Url = string.Empty}}); ;// 为 Swagger JSON and UI设置xml文档注释路径var basePath = Path.GetDirectoryName(typeof(Program).Assembly.Location);//获取应用程序所在目录var xmlPath = Path.Combine(basePath, "MEC.API.xml");c.IncludeXmlComments(xmlPath);});

在Configure中添加代码

 //启用中间件服务生成swagger 作为JSON的终点app.UseSwagger();//启用中间件服务对swagger-ui,指定Swagger JSON终结点app.UseSwaggerUI(c =>{c.SwaggerEndpoint("/swagger/V1/swagger.json", "My API V1");//加上后,访问地址:https://localhost:44388//c.RoutePrefix = "https://localhost:44388/swagger";//访问地址:https://localhost:49382/swagger      });

以上代码直接复制添加即可
打开主项目属性——》生成

1、添加取消警告代码1591;
主要是个人习惯,看着一些无关的警告烦
2、添加xml文档的路径

在地址栏中输入:https://localhost:【prot】/swagger/index.html

如果觉得每次运行项目输入地址,比较麻烦的话
打开项目——》属性

将启动浏览器设置为swagger/index.html

再次运行自动打开swagger页面。

补充,在首次安装中如果出现以下错误,

首先打开运行项目打开地址https://localhost:【port】/swagger/V1/swagger.json

如能成功打开,请检查下在Startup.cs 的配置文件。
例如:

在ConfigureServices方法中的配置,这里的V1是大写字母。

在Configure启动中填写的地址中的v1是小写。所以swagger当然找不到/swagger.json这个文件了。
修改统一的字段,再次运行则可以运行

添加注释说明

效果

-----------------错误2------------

重新把项目搭建了次,然后代码直接copy过来。发现报错了。

打不开https://localhost:【port】/swagger/V1/swagger.json这个文件

最后发现在Configure 没配置

app.UseSwagger();
app.UseSwaggerUI(c =>
{c.SwaggerEndpoint("/swagger/v1/swagger.json", "ApiHelp V1");
});

把以上代码加入到swagger中

swagger在VS2019 .net core2.2中的使用,及报错undefined /swagger/v1/swagger.json的解决办法相关推荐

  1. golang 同一个包中函数互相调用报错 undefined 以及在 VSCode 中配置右键执行整个包文件

    1. 代码结构 demo 文件夹下有两个文件,分别为 hello.go 和 main.go ,结构如下: wohu@wohu:~/GoCode/src$ tree demo/ demo/ ├── he ...

  2. 【Qt】ubuntu14.04.5 qt5.6中使用opencv3.4报错:Using GTK+ 2.x and GTK+ 3 in the same process is not supported

    问题描述 ubuntu14.04.5 qt5.6中使用opencv3.4报错: Using GTK+ 2.x and GTK+ 3 in the same process is not support ...

  3. 安装MHA中清理Relay log报错

    安装MHA中清理Relay log报错 [root@MHA3 ~]#  /usr/bin/purge_relay_logs --user=root --password=123456 -disable ...

  4. HQL语句中数据类型转换,及hibernate中createQuery执行hql报错

    一.HQL语句中数据类型转换: 我们需要从数据库中取出序号最大的记录,想到的方法就是使用order by子句进行排序(desc倒序),然后取出第一个对象,可是当初设计数据库时(我们是在原来的数据库的基 ...

  5. eclipse中同步代码PULL报错checkout conflict with files的解决方法

    eclipse中同步代码PULL报错checkout conflict with files的解决方法 参考文章: (1)eclipse中同步代码PULL报错checkout conflict wit ...

  6. log4j中调试与错误日志分开_idea中log4j日志插件报错

    visual studio code权威指南计算机 65.34元 包邮 (需用券) 去购买 > idea中log4j日志插件报错 在运行测试代码的时候,出现以下错误! 在 src/ main / ...

  7. Linux中使用gcp拷贝报错:dbus.exceptions.DBusException: org.freedesktop.DBus.Error.NotSupported:

    1 在linux中使用gcp拷贝的时候报错 Linux中使用gcp拷贝报错:dbus.exceptions.DBusException: org.freedesktop.DBus.Error.NotS ...

  8. 【错误记录】IntelliJ IDEA 中 Java 代码中的中文注释报错 ( Menu / File / Settings / Editor / File Encodings 中修改工程编码 )

    文章目录 一.报错信息 二.解决方案 一.报错信息 在 IntelliJ IDEA 中 , 出现中文注释报错 ; Y:\002_WorkSpace\003_IDEA\Groovy_Demo\src\m ...

  9. php访问数组用引号_php双引号中访问数组元素报错如何解决

    最近在做微信公众号开发,在一个发送图文接口中,需要把数组元素拼接在XML字符串中,本文主要和大家分享一篇基于php双引号中访问数组元素报错的解决方法,具有很好的参考价值,希望对大家有所帮助.一起跟随小 ...

最新文章

  1. [Advance] How to debug a program (上)
  2. 《智源社区周刊:预训练模型》第1期:吴恩达团队医疗影像预训练、快手落地万亿参数模型...
  3. Trie树进阶:Double-Array Trie原理及状态转移过程详解
  4. mysql/event.myd no fond_mysql Last_Error: Error 'File './sales.MYD' not found (Errcode: 24)
  5. 计算机专业课的教学准备,计算机专业课程教学中的分层教学模式
  6. 同步代码和异步代码_告别异步代码
  7. 正则表达式pcre在Android下的移植
  8. Spark精华问答 | RDD的核心概念是什么?
  9. 计算机键盘输入法基础知识,教程计算机基础知识-:认识输入法
  10. java写的网络版斗地主_JAVA网络版斗地主游戏
  11. 超干货|城市信息模型介绍CIM1-CIM7级
  12. Git报错The requested URL returned error: 403
  13. Web 字体 font-family 浅谈
  14. win10截图软件工具
  15. html5 基本布局+新标签+新选择器 + 线性渐变
  16. Kafka HighLevel API与LowLevel API说明
  17. Parallels Desktop 安装 Windows10 提示“安全启动功能防止操作系统启动”怎么解决?
  18. 服务器运维事项,云服务器的运维工作要注意的事项
  19. 数据结构初阶之二叉树——概念篇
  20. 题解 CF940A 【Points on the line】

热门文章

  1. 2、乐趣国学——“君子慎独”
  2. 【基础知识】现在很火的app上的deeplink技术,到底是什么?
  3. Java安全编程需要考虑的问题
  4. 第一届华数杯A题完整思路分享
  5. 产品研发细腰形架构1/2:产品技术体系的细腰形架构
  6. git-使用staf暂存分支
  7. 通过实例理解Go Execution Tracer
  8. html内联框架导航,html基本格式和内联框架
  9. 对8086的存储器扩展
  10. 架构师之路--从原理角度来分析性能