Swagger 中的 link 不正确

Question

我正在使用 ASP.NET Core 2.0 和 Swashbuckle.AspNetCore (2.4.0)

在启动配置服务中

services.AddSwaggerGen(c =>
        {
            c.OperationFilter<AuthorizationHeaderParameterOperationFilter>();
         c.SwaggerDoc("v1", new Info
            {
                Version = "v1",
                Title = "Library API",
                Description = "ASP.NET Core Web API",
                TermsOfService = "None",
                Contact = new Contact
                {
                    Name = "my name",
                    Email = "myname@mywebsite"
                }
            });
        });
      });

在启动配置中

          app.UseSwagger(c =>
        {
            c.RouteTemplate =
                "api-docs/{documentName}/swagger.json";
        });
        app.UseSwaggerUI(c =>
        {
            c.RoutePrefix = "api-docs";
            c.SwaggerEndpoint("v1/swagger.json", "Api v1");
        });

 public class AuthorizationHeaderParameterOperationFilter : IOperationFilter
    {
        public void Apply(Operation operation, OperationFilterContext context)
        {
            var filterPipeline = context.ApiDescription.ActionDescriptor.FilterDescriptors;
            var isAuthorized = filterPipeline.Select(filterInfo => filterInfo.Filter).Any(filter => filter is AuthorizeFilter);
            var allowAnonymous = filterPipeline.Select(filterInfo => filterInfo.Filter).Any(filter => filter is IAllowAnonymousFilter);

            if (isAuthorized && !allowAnonymous)
            {
                if (operation.Parameters == null)
                    operation.Parameters = new List<IParameter>();

                operation.Parameters.Add(new NonBodyParameter
                {
                    Name = "Authorization",
                    In = "header",
                    Description = "access token",
                    Required = true,
                    Type = "string"
                });
            }
        }
    }

看起来像这样

但是 link 会转到 url

about:blank

如何将 v1/swagger.json link 和服务条款 link 设置到正确的位置？

Answer 1

使用c.SwaggerEndpoint("./v1/swagger.json", "Api v1");

相对路径（不带“/”）呈现为空 link 但 swagger.json 可用且一切正常，这看起来像是一个错误。

我使用相对路径与反向代理一起正常工作，但这是另一回事...

Swagger 中的 link 不正确

Incorrect link in Swagger

swagger

swashbuckle

asp.net-core