.NET 7.0 API：如何让Swagger同时显示OData参数与自定义参数

出现这个问题是因为OData与Swagger的整合逻辑默认会优先处理OData相关参数，导致路由中的templateId没有被Swagger正确识别渲染。以下是几个可行的解决方法：

1. 给路由参数添加[FromRoute]特性 #

明确指定参数的来源是路由，帮助Swagger解析器正确识别这个参数：

[HttpGet]
[EnableQuery]
[Route("/Templates/{templateId:guid}/Sections")]
public IActionResult Get([FromRoute] Guid templateId) { 
    // 业务逻辑
}

2. 确保Swagger启用OData支持 #

首先确认安装了Swashbuckle.AspNetCore.OData NuGet包，然后在Program.cs的Swagger配置中添加OData过滤器：

builder.Services.AddSwaggerGen(c =>
{
    // 其他Swagger配置（比如文档信息等）
    c.EnableAnnotations();
    // 启用OData参数解析支持
    c.AddODataFilter();
});

// OData配置
builder.Services.AddControllers().AddOData(options =>
{
    // 启用需要的OData功能
    options.Select().Filter().OrderBy().Expand().Count().SetMaxTop(100);
    // 关闭限定操作调用，避免路由解析冲突
    options.RouteOptions.EnableQualifiedOperationCall = false;
});

3. 简化路由模板写法 #

避免使用字符串插值生成路由模板，直接写固定模板，减少Swagger解析的不确定性：
把原来的字符串插值路由改为：

[Route("/Templates/{templateId:guid}/Sections")]

以上方法通常能解决Swagger不显示路由参数的问题，优先尝试第一种方法，不行再结合后两种调整配置。

内容的提问来源于stack exchange，提问作者MeanGreen