如何修复 .net core 2.2 应用程序中未找到的 swagger.json

Question

我正在 IIS 服务器上部署我的 .net 核心应用程序，并面临 swagger UI 中找不到 swagger.json 的问题。 当我在本地（开发环境）运行它时，一切正常，但是当我将它部署在 IIS 服务器上时，它找不到 swagger.json 文件。

以前我在 .net core 2.1 应用程序中遇到过这个问题，我通过编写下面的代码来获取虚拟基本路径来解决它。

string basePath = Environment.GetEnvironmentVariable("ASPNETCORE_APPL_PATH");
            basePath = basePath == null ? "/" : (basePath.EndsWith("/") ? basePath : $"{basePath}/");

 app.UseSwaggerUI(c =>
     {
      c.SwaggerEndpoint($"{basePath}swagger/v1/swagger.json", "Test.Web.Api");
      c.RoutePrefix = "";
     });

我试过下面的代码来解决它：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 {
   app.UseSwaggerUI(c =>
     {
      c.SwaggerEndpoint($"{env.ContentRootPath}swagger/v1/swagger.json", "Test.Web.Api");
       //OR
      c.SwaggerEndpoint($"{env.WebRootPath}swagger/v1/swagger.json", "Test.Web.Api");
      c.RoutePrefix = "";
     });
 }

但是上面的代码不起作用，因为它返回实际的物理路径而不是虚拟路径。

• 上面代码的输出：C:/inetpub/wwwroot/myapp/swagger/v1/swagger.json
• 预期输出： http://myserver/MySite/swagger/v1/swagger.json

有谁知道如何在 .net core 2.2 中获取虚拟路径作为Environment.GetEnvironmentVariable("ASPNETCORE_APPL_PATH"); 不管用。 任何线索都会有所帮助。

Answer 1

我通过在我的 .net 核心应用程序中放置以下代码来解决我的问题。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 {
   app.UseSwaggerUI(c =>
     {
      c.SwaggerEndpoint("./swagger/v1/swagger.json", "Test.Web.Api");
      c.RoutePrefix = string.Empty;
    });
 }

根据swashbuckle文档，如果您在 IIS 中托管它，则需要预先添加 ./ 。

我希望这个答案可以节省您的时间！

Answer 2

我试过使用c.SwaggerEndpoint("./swagger/v1/swagger.json", "Test.Web.Api"); 来自Mahesh 的回答，但问题是它确实有帮助。

我已经使用 IIS Express 从 VS 启动了Swashbuckle 示例

我收到错误

未能加载 API 定义。 未定义 ./swagger/v1/swagger.json

何时从 Web 浏览器访问localhost/char/swagger端点。

我修改了launchsettings.json\\iisExpress\\applicationUrl并添加了类似"iisExpress": { "applicationUrl": "http://localhost/char"和Startup.cs源代码这样的路径

   app.UseSwaggerUI(c =>
     {
      c.SwaggerEndpoint("./swagger/v1/swagger.json", "Test.Web.Api");
      c.RoutePrefix = string.Empty;
    });

解决方案是在Github 问题中找到的，请在下面找到它：

app.UseSwaggerUI(c =>
{
    string swaggerJsonBasePath = string.IsNullOrWhiteSpace(c.RoutePrefix) ? "." : "..";
    c.SwaggerEndpoint($"{swaggerJsonBasePath}/swagger/v1/swagger.json", "My API");
});

我没有在文档中看到它，但它在工作时

• 由 IIS Express 在本地托管，在iisExpress\\applicationUrl中的主机名之后带有（或不带有）附加路径
• 由 IIS 在登台环境中托管（在主机名后有额外的路径，如http://staginghost/char/swagger

Answer 3

对于 .net core 5，在项目创建时会自动添加 swagger。

public void ConfigureServices(IServiceCollection services)
{
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "MyProject.Api", Version = "v1" });
    });
}

但是，您需要确保两条注释行在 if 块之外。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IServiceProvider svp)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
                //app.UseSwagger();
                //app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "MyProject.Api v1"));
            }

            app.UseSwagger();
            app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "MyProject.Api v1"));                 

        }

Answer 4

我遇到过这个问题，发现您必须匹配路径中版本的确切类型以及 servicescollection 和 appbuilder

 services.AddSwaggerGen(c => {
    c.SwaggerDoc("v1" , new OpenApiInfo{ Title = "MyApp API" , Version = "v1" });
 });

 app.UseSwagger(); app.UseSwaggerUI(c => { 
    c.SwaggerEndpoint("/swagger/v1/swagger.json","MyApp API v1"); });

Answer 5

在我的情况下，我忘记添加 HTTPGet 属性我的控制器公共获取方法之一

Answer 6

您可以通过以下方式修复相同的问题：

包：#region Assembly Swashbuckle.AspNetCore.Swagger，版本=4.0.1.0

框架：.Net Core 2.2

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // Enable middleware to serve generated Swagger as a JSON endpoint.
    app.UseSwagger();
    // Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.), 
    // specifying the Swagger JSON endpoint.
    app.UseSwaggerUI(c =>
    {
         c.SwaggerEndpoint("/swagger/v1/swagger.json", "Versioned Api v1");
    );
}

当您在本地运行应用程序或托管在 IIS 上时，这是可行的。

Answer 7

对于 .Net Core 2.2

  // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSwaggerDocument();

然后

 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseOpenApi();
            app.UseSwaggerUi3();

        }
        else
        {
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }