.NET 8独立进程Azure Function调整Swagger路径移除/api前缀

DevOps 小满

2026-6-22

解决方案

一、调整Swagger中间件的路由前缀

在Program.cs里配置Swagger时，直接指定路由前缀为docs，让Swagger相关路径脱离/api前缀：

builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "领域API", Version = "v1" });
});

builder.Services.AddEndpointsApiExplorer();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger(c =>
    {
        // 将Swagger的路由前缀设为"docs"，替代默认的"api"
        c.RoutePrefix = "docs";
    });
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/docs/swagger.json", "领域API V1");
    });
}

二、给Function路由添加参数约束

为了彻底避免/api/swagger.json被当成{Id}参数解析，在Function的路由上给id添加类型约束（比如int或Guid），只有符合类型格式的路径才会触发该Function：

示例（int类型Id）：

[FunctionName("GetDomainItem")]
public IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = "api/{id:int}")] HttpRequest req,
    int id,
    ILogger log)
{
    // 业务逻辑实现
    return new OkObjectResult($"获取到ID为{id}的领域数据");
}

示例（Guid类型Id）：

[FunctionName("GetDomainItem")]
public IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = "api/{id:guid}")] HttpRequest req,
    Guid id,
    ILogger log)
{
    // 业务逻辑实现
    return new OkObjectResult($"获取到ID为{id}的领域数据");
}