.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")] 即可。

相关推荐
SEO-狼术5 小时前
Bring Agentic AI to RAD Studio
.net
足球中国6 小时前
.net winform 仿excel控件 开源地址 https://github.com/yufb12/dataexcel_winform
.net
周杰伦fans7 小时前
深入浅出AutoCAD .NET二次开发:HostApplicationServices完全解析
数据库·.net
caimouse7 小时前
Godot 4.7 内嵌 C# 模块切换到 .NET 9.0 编译指南
c#·.net·godot
rockey62717 小时前
基于AScript的SQL脚本语言发布啦!
sql·c#·.net·script·expression·动态脚本
喵叔哟1 天前
14【.NET10 实战--孢子记账--产品智能化】--智能生成预算
大数据·人工智能·.net
mincau1 天前
.NET 反编译代码语义化还原:三工具协同实战
.net·反编译·ai辅助
调试优选官2 天前
2026GEO优化工具软件技术路径拆解:从监测机制到工程落地
.net·软件开发·技术分享·geo
步步为营DotNet2 天前
.NET Aspire 在云原生微服务架构中的深度实践与剖析
云原生·架构·.net
light blue bird2 天前
3C 数码电子BOM 协同工作台组件
java·开发语言·jvm·windows·.net·桌面端