OWIN多实例与Swagger：如何运行多个OWIN应用实例？

嘿，我注意到你在尝试启动多个OWIN实例，还涉及Swagger配置的需求。先给你指出代码里一个容易踩坑的小问题，再聊聊多实例场景下Swagger的正确配置方式：

1. 先修正当前代码的明显错误 #

你代码里第二个OWIN实例启动时，不小心用了option而不是option2，这会导致两个实例绑定到同一个URL（http://localhost:9000/Foo），必然会抛出端口/路径冲突的异常。修正后的代码如下：

var option = new StartOptions();
option.Urls.Add("http://localhost:9000/Foo");
var app = WebApp.Start(option, Startup);

var option2 = new StartOptions();
option2.Urls.Add("http://localhost:9000/Bar");
// 这里要改成option2，避免重复绑定同一个URL
var app2 = WebApp.Start(option2, Startup);

2. 多实例下的Swagger核心配置 #

默认的Swagger配置会把文档和UI挂载到根路径下，多个OWIN实例共用的话会互相覆盖，导致某个实例的Swagger无法正常访问。我们需要给每个实例配置独立的Swagger文档路径和UI路由，核心思路是让Swagger的路径和每个OWIN实例的前缀（Foo/Bar）绑定。

优化后的Startup方法（带前缀参数） #

我们可以把Startup改成带路由前缀参数的委托，这样每个实例启动时传递自己的前缀，就能独立配置Swagger：

// 启动实例时传递各自的路由前缀
var app = WebApp.Start(option, appBuilder => Startup(appBuilder, "/Foo"));
var app2 = WebApp.Start(option2, appBuilder => Startup(appBuilder, "/Bar"));

private static void Startup(IAppBuilder appBuilder, string routePrefix)
{
    var configuration = new HttpConfiguration();
    
    // 给API路由加上实例专属前缀
    configuration.Routes.MapHttpRoute(
        name: "DefaultApi",
        routeTemplate: $"{routePrefix}/api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
    );

    // 配置Swagger生成器：每个实例用独立的文档路径和名称
    configuration.EnableSwagger($"/{routePrefix}/swagger/v1/swagger.json", c =>
    {
        c.SingleApiVersion("v1", $"API {routePrefix.Trim('/')}");
        // 这里可以添加其他Swagger配置，比如加载XML注释、过滤API等
    })
    // 配置Swagger UI：指定专属的UI路径和对应的文档端点
    .EnableSwaggerUi($"/{routePrefix}/swagger", c =>
    {
        c.SwaggerEndpoint($"/{routePrefix}/swagger/v1/swagger.json", $"API {routePrefix.Trim('/')} V1");
        // 其他UI配置，比如自定义样式、启用API测试等
    });

    appBuilder.UseWebApi(configuration);
}

3. 访问方式验证 #

启动两个实例后，你可以分别访问各自的Swagger UI：

• Foo实例：http://localhost:9000/Foo/swagger
• Bar实例：http://localhost:9000/Bar/swagger

每个UI都会加载对应实例下的API文档，不会互相干扰。

内容的提问来源于stack exchange，提问作者Marcus X