在 Azure 的 ASP.NET Core 3.1 应用程序中获取 swagger-ui 返回 404

Posted 2023-03-31

【中文标题】在 Azure 的 ASP.NET Core 3.1 应用程序中获取 swagger-ui 返回 404

【英文标题】：Fetching swagger-ui returns 404 in a ASP.NET Core 3.1 app in Azure

【发布时间】：2021-03-11 09:36:56

【问题描述】：

在加载/swagger/index.html页面时，浏览器找不到部署到Azure中的App Servicce所需的swagger-ui资源，返回404。在本地运行时有效。我的设置是：

  services.AddSwaggerGen(options =>
  
      options.SwaggerDoc("v1", new OpenApiInfo
      
          Title = "Nexus WebApp",
          Version = "v1"
      );
      options.CustomSchemaIds(type => type.ToString());
               
  );

 var builder = endpoints.CreateApplicationBuilder();

 builder.UseSwagger();

 builder.UseSwaggerUI(options =>
 
     options.SwaggerEndpoint("/swagger/v1/swagger.json", "Nexus WebApp");
 );

 var pipeline = builder.Build();

 endpoints.Map("/swagger", pipeline)
     .RequireAuthorization(new AuthorizeAttribute());
 endpoints.Map("/swagger/index.html", pipeline)
     .RequireAuthorization(new AuthorizeAttribute());
 endpoints.Map("/swagger/documentName/swagger.json", pipeline)
     .RequireAuthorization(new AuthorizeAttribute());

我已经尝试过使用像 ..\swagger\v1/swagger.json 这样的 swagger 端点的相对路径，不幸的是，我尝试指定一个 RoutePrefix 都无济于事。我知道有人问过类似的问题，但不幸的是，似乎没有任何帮助。

有人有线索吗？

更新

这些是它返回 404 的资源：

https://domain/swagger/swagger-ui.css https://domain/swagger/swagger-ui-standalone-preset.js https://domain/swagger/swagger-ui-bundle.js

【问题讨论】：

恐怕不行，简单地用你的代码替换我的代码不是答案。

您找到解决方案了吗？

【参考方案1】：

我怀疑，您的实现是错误的。这是在 NET Core 中设置 Swagger UI 的完整 Startup 代码：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Swashbuckle.AspNetCore.Swagger;
namespace IDGSwaggerDemo

    public class Startup
    
        public Startup(IConfiguration configuration)
        
            Configuration = configuration;
        
        public IConfiguration Configuration  get; 
        public void ConfigureServices(IServiceCollection services)
        
            services.AddMvc().SetCompatibilityVersion
            (CompatibilityVersion.Version_2_2);   
            services.AddSwaggerGen(c =>
            
                c.SwaggerDoc("v1", new Info
                
                    Version = "v1",
                    Title = "Swagger Demo",
                    Description = "Swagger Demo for ValuesController",
                    TermsOfService = "None",
                    Contact = new Contact()  Name = "Joydip Kanjilal",
                    Email = "[e-mail]",
                    Url = "www.google.com"
                
                );
            );
        
        public void Configure(IApplicationBuilder app,
       IHostingEnvironment env)
        
            if (env.IsDevelopment())
            
                app.UseDeveloperExceptionPage();
            
            app.UseMvc();
            app.UseSwagger();
            app.UseSwaggerUI(c =>
            
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "v1");
            );
        
    

查看this 教程，了解更多增强的 Swagger 实现。

【讨论】：

我认为可能有些混乱，我已将问题标题编辑为 Core 3.1，如果我没记错的话，您提到的另一个问题是关于框架的。此外，索引页面本身不返回 404，只返回 swagger-ui 资源（js 和 css 文件）

是的，框架和核心是不同的。感谢更新，让我看看这个。 “swagger-ui 资源（js 和 css 文件）”是什么意思？

已经更新了它找不到的确切资源，希望对您有所帮助，谢谢

但是，这些资源会破坏您的 Swagger UI 吗？有什么问题？

是的，没有js或者css页面是空白的