多个webapi项目需要进行集成部署，并且方便前端不产生跨域访问，那肯定是需要部署nginx进行转发，同一域名的情况下，只好采用二级目录进行区分，如果仅仅是webapi的接口转发，相对简单，配置nginx转向目标时添加/字符不转发二级目录路径即可。然而加上swagger后就不灵光了…

1、swagger的二级目录问题

public void ConfigureServices(IServiceCollection services)
           services.AddSwaggerGen(c =>
                c.SwaggerDoc("v1", new OpenApiInfo
                    Version = "v1",
                    Title = "后台API接口文档",
                    Description = "API",
                });
                //Set the comments path for the swagger json and ui.
                var basePath = PlatformServices.Default.Application.ApplicationBasePath;
                var xmlPath = Path.Combine(basePath, "XXX.Apis.xml");
                var dtolXmlPath = Path.Combine(basePath, "XXX.Service.xml");
                c.IncludeXmlComments(xmlPath);
                c.IncludeXmlComments(dtolXmlPath);                
                c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme()
                    Description = "在下框中输入请求头中需要添加Jwt授权Token：Bearer Token",
                    Name = "Authorization",
                    In = ParameterLocation.Header,
                    Type = SecuritySchemeType.ApiKey,
                    BearerFormat = "JWT",
                    Scheme = "Bearer"
                });
                c.AddSecurityRequirement(new OpenApiSecurityRequirement
                        new OpenApiSecurityScheme
                            Reference = new OpenApiReference {
                                Type = ReferenceType.SecurityScheme,
                                Id = "Bearer"
                        new string[] { }
                });
                //c.EnableAnnotations();
            });
            // .net core 支持newstonsoftjson
            services.AddSwaggerGenNewtonsoftSupport();
在配置app内增加
 
 public void Configure(IApplicationBuilder app, IWebHostEnvironment env, ILoggerFactory factory)
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", "App API V1");
            });
如果采用忽略二级目录（不转发二级目录）的nginx配置方式，直接访问api是没有问题的，因为.net core app根本就没接收到二级目录。
 直接访问swagger ui也是没问题的，然而在载入 swagger.json时由于是js载入的路径，会自动带上二级目录，这时候提示 【找不到\二级目录\swagger\v1\swagger.json】的错误提示，到此一步，我竟然轻易就放弃了。
 
以下是我的想法，未验证：
 这时候应该可以直接修改swaggerui配置如下：
 
app.UseSwaggerUI(c =>
          c.SwaggerEndpoint($"/{VDir}/swagger/v1/swagger.json", "Vbms App API V1");
          c.RoutePrefix = $"{VDir}/swagger";     
  });
因为没有测试，不能说一定成功，有时间我测试下这个想法。
 
2、增加虚拟目录配置，并支持
 
首先nginx的配置仍然按照正常转发，二级目录直接转发到.net core app内，这时候对swagger进行如下配置，该配置是翻阅了asp.net core和swagger部分代码而知的，独家分享：
 
// 1.生成json文件时，生成到虚拟目录下，VDir 来自配置
app.UseSwagger(c =>
       if (!string.IsNullOrEmpty(VDir))
          // 设定模板：by webmote csdn
           c.RouteTemplate = $"/{VDir}/swagger/{{documentName}}/swagger.json";
           c.PreSerializeFilters.Add((swaggerDoc, httpReq) =>
               //api测试时增加虚拟目录 或完整路径也可以，完整路径已被webmote注释
               swaggerDoc.Servers = new List<OpenApiServer> { new OpenApiServer {
               Url = $"/{VDir}"
              //  Url = $"{httpReq.Scheme}://{httpReq.Host.Value}/{virtualPath}"
           } };
           });
   });
   // Enable middleware to serve swagger-ui (HTML, JS, CSS etc.), specifying the Swagger JSON endpoint.
   app.UseSwaggerUI(c =>
       if (!string.IsNullOrEmpty(VDir))
           c.SwaggerEndpoint($"/{VDir}/swagger/v1/swagger.json", "App API V1");
           c.RoutePrefix = $"{VDir}/swagger";
           c.SwaggerEndpoint("/swagger/v1/swagger.json", "App API V1");
   });
3、对Api增加虚拟目录支持
 
如果二级目录是固定的，你在控制期路由时，直接写死也是一个办法，只是不太灵活，哈哈。
 例如： [Route("二级目录/api/[controller]/[action]")]
 微软的某一篇文章说 使用 ~开头的路由路径可以支持虚拟目录，我试了，不行！
 
这里采用的时.net core 3引入的动态自定义路由方案,可以灵活配置。 增加自定义的路由转换类
 
public class MyTransformer : DynamicRouteValueTransformer
        private string _route = string.Empty;
        public MyTransformer(string route)
            _route = route;
        public override ValueTask<RouteValueDictionary> TransformAsync(HttpContext httpContext, RouteValueDictionary values)
            if (!values.ContainsKey("dir")) return new ValueTask<RouteValueDictionary>(values);
            var dir = (string)values["dir"];
            return new ValueTask<RouteValueDictionary>(values);
这里引入了{dir}路由配置，把该类注入到服务中
 
if (!string.IsNullOrEmpty(VDir))
      services.AddSingleton<MyTransformer>(new MyTransformer(VDir));
在终结点配置时，增加对二级目录的路由解释映射。
 
 app.UseEndpoints(endpoints =>
       endpoints.MapControllers();
       if (!string.IsNullOrEmpty(VDir))
           //这里是webmote定义的路由映射，可以方便的忽略二级目录
           endpoints.MapDynamicControllerRoute<MyTransformer>("{dir}/api/{controller}/{action}/{id?}");
   });
控制器WebApi的路由保持不变，不需要增加二级目录的！
 [Route("api/[controller]/[action]")]
 
当遇到特别难处理的问题时，最好的办法时先搜索看看有无前辈解决过类似问题，如果没有的话，那就别迟疑了，快快翻看源代码，仔细查阅下有什么办法可以注入处理程序，拦截下原有处理方式。
 
没事多阅读<微软文档>
百度
csdn
博客园
github 微软的asp.net core
                    多个webapi项目需要进行集成部署，并且方便前端不产生跨域访问，那肯定是需要部署nginx进行转发，同一域名的情况下，只好采用二级目录进行区分，如果仅仅是webapi的接口转发，相对简单，配置nginx转向目标时添加/字符不转发二级目录路径即可。然而加上swagger后就不灵光了…1、swagger的二级目录问题.net core 3.1环境下，我们采用的是引入 Swashbuckle....
				
Furion框架使用Swagger来生成API文档。如果需要修改Swagger根目录，可以按照以下步骤进行操作：
在Furion项目中找到appsettings.json文件，并打开它。
在appsettings.json文件中，找到名为SwaggerOptions的配置项，该配置项用于配置Swagger相关的设置。
在SwaggerOptions中，可以找到一个名为RoutePrefix的...
				
Swagger 是一个规范且完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。
2.编写代码
代码如下（示例）：application.properties
application-dev.properties(开发环境)
application-pro.properties(生产环境)
User类
Controller类
swagger配置类
马上来查看效果...
				
Swagger的配置
swagger概述
Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。 总体目标是使客户端和文件系统作为服务器以同样的速度来更新。 文件的方法/参数/模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。
一、添加maven依赖
<!--配置swagger-->
    <dependency>
       <groupId>i
				
ASP.NET Core Web API 是一种用于构建 Web API 的框架。它是微软开发的一个开源框架，旨在提供高性能、可扩展性和可靠性，支持跨平台开发，并且易于使用。
ASP.NET Core Web API 基于 .NET Core 平台，可以运行在 Windows、Linux 和 macOS 等多个操作系统上。它支持使用 C# 或者其他 .NET 支持的语言进行开发，并且提供了许多开箱即用的功能，如模型绑定、身份验证、授权、路由等等。
使用 ASP.NET Core Web API，你可以构建 RESTful API，支持多种数据格式，如 JSON、XML 等等。你还可以轻松地集成其他框架和工具，如 Swagger、Entity Framework Core、SignalR 等等。
总之，ASP.NET Core Web API 是一个功能强大、灵活、易于使用的框架，非常适合构建 Web API。
                EF Core Error:Unable to cast object of type ‘System.DBNull‘ to type ‘System.String‘
                    H.X.C: 
                    我也想到了这个问题，但我不太认可该方式，因为如果这个实体在多处被引用，那么一旦修改该类型就会起连锁反应。所以我想应该有更好的办法，但我还没想到，希望能多多交流。
                重磅级视频直播推流服务，支持H265——Go2RTC
                    云来雁去: 
                    小伙子，你买票了吗？哪来的关注费啊
                重磅级视频直播推流服务，支持H265——Go2RTC
                    webmote: 
                    下一步还要写使用呢，这写不写呢
                重磅级视频直播推流服务，支持H265——Go2RTC
                    webmote: 
                重磅级视频直播推流服务，支持H265——Go2RTC
                    superxxd: 
                    现在拿别人的开源项目都可以来挣关注费了