.Net Framework 4.8部署后Swagger UI访问404问题求助

• 适配.NET Framework的环境变量
  .NET Framework项目不识别ASPNETCORE_ENVIRONMENT，改用ASPNET_ENV作为环境标识变量，在服务器上设置该变量值为Development即可。

• 给SwaggerConfig添加环境判断逻辑
  在Swagger注册代码里加入环境判断，只有指定环境才启用Swagger，避免生产环境意外暴露或部署后路由失效。修改后的代码示例：

  using Swashbuckle.Application;
  using System;
  using System.Configuration;
  
  [assembly: PreApplicationStartMethod(typeof(SwaggerConfig), "Register")]
  namespace App.API
  {
      public class SwaggerConfig
      {
          public static void Register()
          {
              // 优先读服务器环境变量，没有则读web.config配置，默认生产环境
              var currentEnv = Environment.GetEnvironmentVariable("ASPNET_ENV") ?? 
                                ConfigurationManager.AppSettings["ASPNET_ENV"] ?? 
                                "Production";
  
              // 仅开发环境启用Swagger
              if (currentEnv.Equals("Development", StringComparison.OrdinalIgnoreCase))
              {
                  var thisAssembly = typeof(SwaggerConfig).Assembly;
                  GlobalConfiguration.Configuration
                      .EnableSwagger(c =>
                      {
                          // 保留原有Swagger配置，比如指定API版本等
                          c.SingleApiVersion("v1", "App.API");
                      })
                      .EnableSwaggerUi(c =>
                      {
                          // UI相关配置，可按需添加
                      });
              }
          }
      }
  }
  

• 检查部署文件完整性
  确认服务器上的部署包包含Swashbuckle的静态资源文件——也就是项目里Content和Scripts目录下的Swagger相关css、js文件，部署时别把这些文件排除了，否则UI页面会因为资源缺失导致404或无法正常加载。

• 排查路由与权限问题
  检查IIS站点的URL重写规则、权限设置，确保/swagger/ui路径没有被拦截；同时确认WebAPI的路由配置正常，没有覆盖Swagger的路由规则。

• 备选：用web.config配置环境
  如果不想依赖服务器环境变量，直接在web.config的<appSettings>节点添加配置项，不同环境用不同的web.config文件即可：

  <appSettings>
      <add key="ASPNET_ENV" value="Development" />
  </appSettings>
  

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