swagger在VS2019 .net core2.2中的使用,及报错undefined /swagger/v1/swagger.json的解决办法
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的解决办法相关推荐
- golang 同一个包中函数互相调用报错 undefined 以及在 VSCode 中配置右键执行整个包文件
1. 代码结构 demo 文件夹下有两个文件,分别为 hello.go 和 main.go ,结构如下: wohu@wohu:~/GoCode/src$ tree demo/ demo/ ├── he ...
- 【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 ...
- 安装MHA中清理Relay log报错
安装MHA中清理Relay log报错 [root@MHA3 ~]# /usr/bin/purge_relay_logs --user=root --password=123456 -disable ...
- HQL语句中数据类型转换,及hibernate中createQuery执行hql报错
一.HQL语句中数据类型转换: 我们需要从数据库中取出序号最大的记录,想到的方法就是使用order by子句进行排序(desc倒序),然后取出第一个对象,可是当初设计数据库时(我们是在原来的数据库的基 ...
- eclipse中同步代码PULL报错checkout conflict with files的解决方法
eclipse中同步代码PULL报错checkout conflict with files的解决方法 参考文章: (1)eclipse中同步代码PULL报错checkout conflict wit ...
- log4j中调试与错误日志分开_idea中log4j日志插件报错
visual studio code权威指南计算机 65.34元 包邮 (需用券) 去购买 > idea中log4j日志插件报错 在运行测试代码的时候,出现以下错误! 在 src/ main / ...
- Linux中使用gcp拷贝报错:dbus.exceptions.DBusException: org.freedesktop.DBus.Error.NotSupported:
1 在linux中使用gcp拷贝的时候报错 Linux中使用gcp拷贝报错:dbus.exceptions.DBusException: org.freedesktop.DBus.Error.NotS ...
- 【错误记录】IntelliJ IDEA 中 Java 代码中的中文注释报错 ( Menu / File / Settings / Editor / File Encodings 中修改工程编码 )
文章目录 一.报错信息 二.解决方案 一.报错信息 在 IntelliJ IDEA 中 , 出现中文注释报错 ; Y:\002_WorkSpace\003_IDEA\Groovy_Demo\src\m ...
- php访问数组用引号_php双引号中访问数组元素报错如何解决
最近在做微信公众号开发,在一个发送图文接口中,需要把数组元素拼接在XML字符串中,本文主要和大家分享一篇基于php双引号中访问数组元素报错的解决方法,具有很好的参考价值,希望对大家有所帮助.一起跟随小 ...
最新文章
- [Advance] How to debug a program (上)
- 《智源社区周刊:预训练模型》第1期:吴恩达团队医疗影像预训练、快手落地万亿参数模型...
- Trie树进阶:Double-Array Trie原理及状态转移过程详解
- mysql/event.myd no fond_mysql Last_Error: Error 'File './sales.MYD' not found (Errcode: 24)
- 计算机专业课的教学准备,计算机专业课程教学中的分层教学模式
- 同步代码和异步代码_告别异步代码
- 正则表达式pcre在Android下的移植
- Spark精华问答 | RDD的核心概念是什么?
- 计算机键盘输入法基础知识,教程计算机基础知识-:认识输入法
- java写的网络版斗地主_JAVA网络版斗地主游戏
- 超干货|城市信息模型介绍CIM1-CIM7级
- Git报错The requested URL returned error: 403
- Web 字体 font-family 浅谈
- win10截图软件工具
- html5 基本布局+新标签+新选择器 + 线性渐变
- Kafka HighLevel API与LowLevel API说明
- Parallels Desktop 安装 Windows10 提示“安全启动功能防止操作系统启动”怎么解决?
- 服务器运维事项,云服务器的运维工作要注意的事项
- 数据结构初阶之二叉树——概念篇
- 题解 CF940A 【Points on the line】