.net8 Swashbuckle.AspNetCore WEBAPI 配置要点记录

1. 因Controllers中一个方法缺少 HttpMethod特性,导至Swagger报错,报错信息如下:

Swashbuckle.AspNetCore.SwaggerGen.SwaggerGeneratorException: Ambiguous HTTP method for action - XXXX.GetXXXXController.幽幽x. Actions require an explicit HttpMethod binding for Swagger/OpenAPI 3.0

解决办法:

检查所有Action,确保所有Action上面都有正确的HttpMethod特性。

或者在AddSwagger的时候设置一下,让Swagger忽略没有HttpMethod特性的Action,方法是在在Program.cs文件中把 builder.Services.AddSwaggerGen() 这行代码替换成

builder.Services.AddSwaggerGen(options =>

{

options.DocInclusionPredicate((name, api) => api.HttpMethod != null);

});

2. 允许一个ApiController中出现多个请求方法相同的Action

只需把该ApiController中 路由规则 Route("api/\[controller")] 替换成 Route("api/\[controller/action")] 即可。

相关推荐
半亩码田9 小时前
【.NET新特性·第10篇】.NET 10 概览:LTS 版本的全面进化
大数据·.net
回忆2012初秋1 天前
.NET 中 TAP:构建健壮后台任务(BackgroundService)的完全指南(二)
网络·.net
猿长大人1 天前
C# | MediatR 入门指南:后端架构解耦
分布式·后端·架构·c#·.net
海盗12341 天前
微软技术日报——2026-08-06
人工智能·microsoft·.net
Murphy20232 天前
.net10 WEB API项目中启用Swagger 页面的配置步骤
swagger·asp.net web api·.net10
猿长大人2 天前
C# | 函数式编程入门
开发语言·c#·.net
L歪歪君 山水甲天3 天前
Office文件的奥秘——.NET平台下不借助Office实现Word、Powerpoint等文件的解析(1)
word·powerpoint·.net
de之梦-御风3 天前
【工业自动化平台】 工程设计-依赖注入控制反转(2)
架构·自动化·.net
残月心殇 请珍惜枸3 天前
.NET陷阱之五:奇怪的OutOfMemoryException——大对象堆引起的问题与对策
java·jvm·.net