开发者社区

文档建议反馈控制台

最新优惠活动

文章/答案/技术大牛

发布

方法不会在Swagger UI中显示(w/ Swashbuckle)，但没有错误消息

Swagger UI是一个用于可视化和测试API的工具，而Swashbuckle是一个用于将ASP.NET Web API项目集成到Swagger UI中的库。根据提供的问答内容，问题是关于在Swagger UI中不显示方法且没有错误消息的情况。

造成方法不显示的原因可能有以下几种可能性：

缺少必要的Swagger注解：在ASP.NET Web API项目中，Swagger UI通过读取代码中的注解来生成API文档。确保在控制器和操作方法上添加了必要的Swagger注解，例如[SwaggerOperation]和[ProducesResponseType]等。
Swagger配置错误：检查项目中的Swagger配置文件，通常是SwaggerConfig.cs或Startup.cs文件。确保配置文件中的路由和程序集等信息正确。
缺少必要的引用：确保项目中已经安装并引用了Swashbuckle相关的NuGet包，例如Swashbuckle.AspNetCore。
编译错误：如果代码中存在编译错误，可能会导致Swagger UI无法正确解析API。检查项目中的编译错误并解决它们。
版本不兼容：Swashbuckle和Swagger UI有不同的版本，确保它们之间的版本兼容性。

如果以上方法都无法解决问题，可以尝试以下步骤进行排查：

清理和重新生成项目：删除项目的临时文件和生成的文件，然后重新生成项目。
重启应用程序：有时候重新启动应用程序可以解决一些奇怪的问题。
查看日志：检查应用程序的日志文件或控制台输出，查看是否有与Swagger或Swashbuckle相关的错误消息。

总结起来，要解决方法不在Swagger UI中显示的问题，需要确保正确使用Swagger注解、正确配置Swagger和Swashbuckle，检查引用和版本兼容性，并排查其他可能的错误。如果问题仍然存在，可以尝试清理和重新生成项目，重启应用程序，并查看日志文件以获取更多信息。

腾讯云相关产品和产品介绍链接地址：

腾讯云API网关：https://cloud.tencent.com/product/apigateway
腾讯云云函数（Serverless）：https://cloud.tencent.com/product/scf
腾讯云容器服务：https://cloud.tencent.com/product/ccs
腾讯云数据库：https://cloud.tencent.com/product/cdb
腾讯云CDN：https://cloud.tencent.com/product/cdn
腾讯云人工智能：https://cloud.tencent.com/product/ai
腾讯云物联网：https://cloud.tencent.com/product/iot
腾讯云移动开发：https://cloud.tencent.com/product/mad
腾讯云对象存储：https://cloud.tencent.com/product/cos
腾讯云区块链：https://cloud.tencent.com/product/baas
腾讯云游戏多媒体处理：https://cloud.tencent.com/product/gmp
腾讯云元宇宙：https://cloud.tencent.com/product/mu

页面内容是否对你有帮助？

有帮助

没帮助

相关·内容

ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

引言在使用asp.net core 进行api开发完成后，书写api说明文档对于程序员来说想必是件很痛苦的事情吧，但文档又必须写，而且文档的格式如果没有具体要求的话，最终完成的文档则完全取决于开发者的心情...那么有没有一种快速有效的方法来构建api说明文档呢？答案是肯定的， Swagger就是最受欢迎的REST APIs文档生成工具之一！...Info { Title = "My API", Version = "v1" }); }); 在 Startup.Configure 方法中，启用中间件为生成的 JSON 文档和 Swagger UI...生成的描述终结点的文档显示如下json格式。 ? 可在 http://localhost:/swagger 找到 Swagger UI。...通过上面的操作可以总结出，Swagger UI 显示上述注释代码的元素的内部文本作为api大的注释！当然你还可以将 remarks 元素添加到 Get 操作方法文档。

3.2K1 0

webapi文档描述-swagger

和Swagger.Net.UI两个包 ? 　　...3.卸载重复包Swagger.Net 　　引用Swagger.Net.UI时会引用Swagger.Net这个包，但是Swagger.Net的功能和Swashbuckle重复了。...Rendering Swagger UI": "已加载资源信息。...View Code c.CustomProvider((defaultProvider) => new CachingSwaggerProvider(defaultProvider)); 上面汉化的js中的方法...Swagger的读取所有Controller和Action借助于IApiExplorer接口的方法GetApiExplorer，其中IApiExplorer在System.Web.Http中。 ?

1.7K9 0

MongoDB从入门到实战之.NET Core使用MongoDB开发ToDoList系统（2）-Swagger框架集成

框架介绍 GitHub源码地址：https://github.com/domaindrivendev/Swashbuckle.AspNetCore Swashbuckle包含了Swagger UI...它通常与 Swagger 终结点中间件结合，以自动公开 Swagger JSON。 Swashbuckle.AspNetCore.SwaggerUI：Swagger UI 工具的嵌入式版本。...添加并配置Swagger中间件 1、将 Swagger生成器添加到 Program.cs 中的服务容器中： // 添加Swagger服务 builder.Services.AddSwaggerGen...调用 AddMvcCore 时，必须显式调用 AddApiExplorer 方法。有关详细信息，请参阅 Swashbuckle、ApiExplorer 和路由。...UI 显示版本的信息如下所示： API Swagger添加描述在 Program.cs 中注入XML相关描述：注意：将 Swagger 配置为使用按照上述说明生成的 XML 文件。

1.2K2 0

Asp.Net WebApi在swagger中添加版本控制

在Asp.Net WebApi中添加版本控制，同时在swagger中按版本显示接口 ---- 引用版本控制包 <package id="Microsoft.AspNet.WebApi.Versioning...，如果<em>没有</em>带版本则默认1.0，请求可以通过query参数或者header方式，名称为api-version，这个名称是在前述代码<em>中</em>配置的可能遇到的问题 <em>swagger</em>描述<em>中</em>的中文乱码，可以用vs新建一个...，这是注册<em>swagger</em>的顺序<em>错误</em>，要把SwaggerConfig.Register(config, apiExplorer);放到路由注册之后。...选择api版本后<em>swagger</em> <em>ui</em>页面<em>没有</em>刷新，还是<em>显示</em>上一个版本，选择版本后需要失去焦点再回车，不然会弹出选择框继续选择 ---- 参考资料 aspnet-api-versioning-SwaggerWebApiSample...<em>Swagger</em> <em>UI</em> 中文乱码解决

2.2K2 0

如何使 WebAPI 自动生成漂亮又实用在线API文档「建议收藏」

1.2 Swashbuckle Swashbuckle 是.NET类库,可以将WebAPI所有开放的控制器方法生成对应SwaggerUI的JSON配置。再通过SwaggerUI 显示出来。...Swashbuckle 是通过生成的XML文件来读取注释的，生成 SwaggerUI，JSON 配置中的说明的。...image.png 将配置文件大概99行注释去掉并修改为 c.IncludeXmlComments(GetXmlCommentsPath(thisAssembly.GetName().Name)); 并在当前类中添加一个方法...“XML 文档文件”，编译过程中生成类库的注释文件 image.png 添加百度音乐 3个API image.png 访问 http:///swagger/ui/index,最终显示效果 image.png...swagger-ui 项目地址： https://github.com/swagger-api/swagger-ui swagger-ui 官网地址： http://swagger.io/swagger-ui

1.1K2 0

webapi文档描述-swagger

Swashbuckle和Swagger.Net.UI两个包　　3.卸载重复包Swagger.Net 　　引用Swagger.Net.UI时会引用Swagger.Net这个包，但是Swagger.Net...Petstore Example Apis": "显示 Swagger Petstore 示例 Apis", "Can't read from server....Rendering Swagger UI": "已加载资源信息。...View Code c.CustomProvider((defaultProvider) => new CachingSwaggerProvider(defaultProvider)); 上面汉化的js中的方法...Swagger的读取所有Controller和Action借助于IApiExplorer接口的方法GetApiExplorer，其中IApiExplorer在System.Web.Http中。

1.1K1 0

【ASP.NET Core 基础知识】--Web API--Swagger文档生成

dotnet add package Swashbuckle.AspNetCore 配置Swagger服务：在Startup.cs文件的ConfigureServices方法中，添加Swagger服务的配置...中间件：在Startup.cs文件的Configure方法中，启用Swagger中间件，并配置UI的端点。...3.3 隐藏敏感信息在Swagger文档中，有时需要隐藏敏感信息，以确保不会在文档中泄露敏感数据。...定期审查和更新：定期审查Swagger文档中的信息，确保它们仍然是准确的，敏感信息没有泄露，并且符合最新的安全标准。...UI 配置认证按钮：为了让Swagger UI显示认证按钮，你可以添加一个JavaScript文件，并在Swagger配置中引入该文件。

1380 0

Swashbuckle.AspNetCore3.0的二次封装与使用

关于 Swashbuckle.AspNetCore3.0 一个使用 ASP.NET Core 构建的 API 的 Swagger 工具。...直接从您的路由，控制器和模型生成漂亮的 API 文档，包括用于探索和测试操作的 UI。...currentAssembly.GetManifestResourceStream($"{currentAssembly.GetName().Name}.index.html"); } 若想注入 css，js 则在 UseSwaggerUIAction 委托中调用对应的方法接口...，官方文档另外，目前 swagger-ui 3.19.0 并不支持多语言，不过可以根据需要使用 js 去修改一些东西比如在 index.html 的 onload 事件中这样去修改头部信息 document.getElementsByTagName...主题时使用的swagger-ui 为 3.19.0，从issues2488了解到目前不支持多语言，其他的问题也可以查看此仓库在使用过程中遇到的问题，基本上 readme 和 issues 都有答案

9164 0

【愚公系列】2023年02月 WMS智能仓储系统-007.Swagger接口文档的配置

文件的方法、参数和模型紧密集成到服务器端的代码，允许 API 来始终保持同步。Swagger 让部署管理和使用功能强大的 API 从未如此简单。...Swagger UI – 将 OpenAPI 定义呈现为交互式文档。 Swagger Codegen – 从 OpenAPI 定义生成服务器存根和客户端库。...接口文档的配置 1.安装包 Swashbuckle.AspNetCore Swashbuckle.AspNetCore.Filters 2.注入 2.1 Swagger服务的注入 #region 添加接口文档...文档使用ApiExplorerSettings特性表名该接口属于Base文档 ApiExplorerSettingsAttribute还有个IgnoreApi属性，如果设置成true，将不会在swagger...，那么久可以使用http://host:port直接访问到SwaggerUI页面了 3、IndexStream Swagger的UI页面是嵌入的资源文件，默认值是： app.UseSwaggerUI(options

8772 0

使用Swagger生成ASP.NET Web API的文档

在本文中，我将介绍一些可以为ASP.NET Web API生成文档的方法。...UI，如下所示: [图片] [图片] 非常非常令人印象深刻的动态文档UI。...这里的关键是在生成的JSON中，可以通过文本框中的URI访问，在我的情况下是: http://localhost:2218/swagger/docs/v1(swagger.json） [图片] swagger...在安装JDK之后（如果你还没有的话），你需要确保JAVA_HOME 环境变量正确地运行在正确的目录下（而不是运行时目录），并安装/提取Maven二进制文件。...在我的情况下，我把提取的swagger文件放在C:\ Tools中。

3.3K0 0

.NET Core 3.0 使用Nswag生成Api文档和客户端代码

Swagger 是一个与语言无关的规范，用于描述 REST API。Swagger 项目已捐赠给 OpenAPI 计划，现在它被称为开放 API。这两个名称可互换使用，但 OpenAPI 是首选。...NSwag 是另一个用于生成 Swagger 文档并将 Swagger UI 或 ReDoc 集成到 ASP.NET Core Web API 中的开源项目。...为什么我在.NET core3.0中选择NSwag呢，因为Swashbuckle目前不在维护了，而NSwag比较活跃，一直在更新，功能也很强大，可以完美的代替Swashbuckle.AspNetCore...生成api文档（默认路由文档 /swagger/v1/swagger.json） app.UseSwaggerUi3();//添加Swagger UI到请求管道中(默认路由: /...swagger). } 配置项目运行项目右键项目在浏览器中查看，查看swagger UI需要在url后面添加“/swagger”。

4.6K1 0

在asp.net core2.1中添加中间件以扩展Swashbuckle.AspNetCore3.0支持简单的文档访问权限控制

Swashbuckle.AspNetCore3.0 介绍一个使用 ASP.NET Core 构建的 API 的 Swagger 工具。...直接从您的路由，控制器和模型生成漂亮的 API 文档，包括用于探索和测试操作的 UI。...继上篇Swashbuckle.AspNetCore3.0 的二次封装与使用分享了二次封装的代码，本篇将分享如何给文档添加一个登录页，控制文档的访问权限(文末附完整 Demo) 关于生产环境接口文档的显示...我有两种想法将路由前缀改得超级复杂添加一个拦截器控制 swagger 文档的访问必须获得授权(登录) 大佬若有更好的想法，还望指点一二下面我将介绍基于 asp.net core2.1 且使用了 Swashbuckle.AspNetCore3.0...swagger 相关请求，判断是否授权登录若未登录则跳转到授权登录页，登录后即可访问 swagger 的资源如果项目本身有登录系统，可在自定义中间件中使用项目中的登录，没有的话，我会分享一个简单的用户密码登录的方案

1.1K1 0

使用Swagger记录ASP.NET Web API

在本文中，我将介绍一些可以为ASP.NET Web API生成文档的方法。在开发Web API的过程中你会发现，默认模板已经包含了为可实现的API 生成文档的功能。...安装完成后，你只需更改项目设置以生成XML说明文件（这不是必需的步骤，但很有用 - 请参阅下面的图像），然后配置App_Startup文件夹下的SwaggerConfig.cs文件。...UI，如下所示： [fu7hh1znp.png] [qjk342ru1q.png] 这是十分令人印象深刻的动态文档UI。...我将Maven安装了在Java目录中，并把它（特别是bin目录）添加到系统路径(System Path)中： [e1d487cj1e.png] 准备好之后，你需要将Swagger Codegen代码解压缩到本地目录中...根据我的配置，我把提取的swagger文件放在C:\Tools中。

2.2K7 0

【swagger】C# 中 swagger 的使用及避坑

3 显示说明 swagger 可以读取代码中的注释，并显示在网页上。如此一来，我们只需要在代码中将注释写好，就可以生成一份可供他人阅读的 API 文档了。...Rendering Swagger UI": "已加载资源信息。..."); }); 5 路由相同，查询参数不同的方法在实际的 ASP.NET Web API 中，是可以存在路由相同，HTTP 方法相同，查询参数不同的方法的，但不好意思，swagger...这可以避免报错，但多个方法只会在 swagger 中展示一个。治标不治本，不推荐。所以唯一的解决方案就是设置成不同的路由。不知道这个问题在之后的版本中会不会修复。...给这些属性标记上 [Newtonsoft.Json.JsonIgnore] 特性，swagger 中不再显示了。

6.1K2 0

ASP.NET Core 实战：构建带有版本控制的 API 接口

首先我们需要在 ConfigureServices 方法中，将我们的服务添加到 IServiceCollection 容器中，这里，我们需要为生成的 Swagger Document 进行一些配置。...我们使用 API 文档的目的，就是为了让前端知道请求的方法地址是什么，需要传递什么参数，而现在，并没有办法显示出我们对于参数以及方法的注释，通过查看 Swashbuckle.AspNetCore 的 github...在重新生成项目的过程中，你会发现，错误列表会显示很多警告信息，提示我们一些方法没有添加 XML 注释。...如果你和我一样强迫症的话，可以把 1591 这个错误添加到上面的禁止显示警告中，这样就可以不再显示这个警告了。 ? 　　...通过 Swagger 自带的 API 测试工具测试下我们的接口，原来这里请求的 Url 中已经包含了我们定义的版本信息，当我们指定错误的版本信息时，工具也会告诉我们这个版本的接口不存在。 ?

1.2K3 0

我这么玩Web Api（一）

Web API的方法列表已经显示出来了，但是方法的描述还是默认的描述。 3. 修改配置文件生成位置　　右键项目属性，指定输出xml。 ? 　　...修改Areas\HelpPage\App_Start\HelpPageConfig.cs中register方法里指定的xml路径为上述指定输出的路径。 ? 　　...再查看帮助页面，方法描述已经和代码注释一致。 ? 　　注：这里可根据需要把Area中对应页面的英文词条更新成中文，当然样式也可以调整。...然后就可以浏览生成的帮助页面：http://localhost:xxxx/swagger ? 　　Web API的方法列表已经显示出来了，但是方法的描述还没有显示出来。 2....常见异常　　用Nuget引用dll的时候，它会在config中添加依赖项信息，但偶尔会没添加，这时会出现Could not load file or assembly 'XXX' or one of

7175 0

如何在 asp.net core 的中间件中返回具体的页面

，我们经常实现的是鉴权、请求日志记录、全局异常处理等等这种非业务性的需求，而如果你有在 asp.net core 中使用过 swashbuckle(swagger)、health check、mini...，从而给我们的功能实现提供一个思路在 asp.net core 中使用 Swashbuckle.AspNetCore 时，我们通常需要在 Startup 类中针对组件做如下的配置，根据当前程序的信息生成...}); } } 可以看到最终呈现给用户的页面，其实是在 Configure 方法中通过调用 UseSwaggerUI 方法来完成的，这个方法是在 Swashbuckle.AspNetCore.SwaggerUI...在一个 asp.net core 中间件中，核心的处理逻辑是在 Invoke/InvokeAsync 方法中，结合我们使用 swagger 时的场景，可以看到，在将组件中所包含的页面呈现给用户时，主要存在如下两个处理逻辑...SwaggerUIMiddleware { private const string EmbeddedFileNamespace = "Swashbuckle.AspNetCore.SwaggerUI.node_modules.swagger_ui_dist

2K2 0

尝新体验ASP.NET Core 6预览版本中的最小Web API(minimal APIS)新特性

在Visual Studio 2022中，按F5运行，如果在浏览中打开并显示如下页面，说明最小API项目运行正常，如图：在最小API项目中，直接调用WebApplication.MapGet()方法即可完成路由的注册和映射...首先，在Nuget包管理工具中搜索Swashbuckle，然后安装Swashbuckle.AspNetCore组件，如图：然后注册Swagger的服务和路由，完整的示例如下： using Microsoft.OpenApi.Models...注册Swagger的路由 /// app.UseSwagger(); /// /// 注册Swagger UI的路由 /// app.UseSwaggerUI...(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "Api v1")); app.Run(); 运行后的Swagger界面如图：在最小API应用程序中...的路由 /// app.UseSwagger(); /// /// 注册Swagger UI的路由 /// app.UseSwaggerUI

5K3 0

ASP.NET WebAPI 测试文档 (Swagger)

使用swagger 1.创建webapi项目解决方案 2.引用swagger nuget包 swashbuckle和swagger.NET 删除多余的SwaggerUI文件夹和配置类SwaggerNet...Petstore Example Apis": "显示 Swagger Petstore 示例 Apis", "Can't read from server....可能没有正确设置access-control-origin。"...Rendering Swagger UI": "已加载资源信息。...正在渲染Swagger UI", "Unable to read api": "无法读取api", "from path": "从路径", "Click to set as parameter value

1.7K4 1

(转载非原创)由ASP.NET Core WebApi添加Swagger报错引发的探究

本篇文章记录一下，笔者在使用ASP.NET Core开发Api的过程中，给接口整合Swagger过程中遇到的一个异常，笔者抱着好奇的心态研究了一下异常的原因，并解决了这个问题。...3.0要求Action上必须绑定HttpMethod相关Attribute，否则就报这一大堆错误。...Swashbuckle.AspNetCore入手# 在GitHub上找到Swashbuckle.AspNetCore仓库位置，近期GitHub不太稳定，除了梯子貌似也没有很好的办法，多刷新几次将就着用吧...Configure方法中，为了清晰和Swagger中间件放到一起后，效果如下 if (!...(); } 加完之后重新运行项目，打开swagger地址http://localhost:5000/swagger没有异常，在Swagger上调用了接口试了一下，没有任何问题。

1.7K0 0

点击加载更多

扫码

添加站长进交流群

领取专属 10元无门槛券

手把手带您无忧上云

扫码加入开发者社群

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭