为何Azure与本地环境Swagger的RoutePrefix配置需不同？

问题背景 #

我发现只有通过以下配置，才能让Swagger在本地开发环境和Azure部署环境同时正常工作：

app.UseDeveloperExceptionPage();
app.UseSwagger();
app.UseSwaggerUI(x =>
{
    // For Debug in Kestrel
    x.SwaggerEndpoint("/swagger/v1/swagger.json", "Web API V1");
#if DEBUG
    x.RoutePrefix = "swagger"; // For localhost
#else
    x.RoutePrefix = string.Empty; //  For azure
#endif
}
);

想请教为什么Azure和本地环境的RoutePrefix配置必须不同？

更新补充 #

如果使用如下统一配置：

// generated swagger json and swagger ui middleware
app.UseDeveloperExceptionPage();
app.UseSwagger();
app.UseSwaggerUI(x =>
{
    // For Debug in Kestrel
    x.SwaggerEndpoint("/swagger/v1/swagger.json", "Web API V1");
    x.RoutePrefix = "swagger";
}
);

本地运行时一切正常，启动后浏览器能打开正确的Swagger UI页面。但通过Visual Studio 2022发布到Azure后，构建完成时启动的浏览器显示错误页面，URL里没有包含"swagger"字段，搞不懂这是为什么。

原因分析 #

• Azure App Service默认路由与自动跳转逻辑：Azure部署的应用默认访问入口是根路径（/），且Visual Studio发布后自动打开的是根URL。如果RoutePrefix设为swagger，正确访问路径应为https://你的azure域名/swagger，但自动打开的根路径没有关联Swagger UI，所以显示错误。而本地开发时，Kestrel服务器默认导航到/swagger，与配置匹配，因此正常。
• 路由优先级与静态文件冲突：Azure环境中静态文件中间件可能优先匹配根路径，若RoutePrefix设为swagger，Swagger的路由可能被静态文件路由覆盖，导致无法访问。将RoutePrefix设为空字符串，让Swagger UI绑定到根路径，就能避开这个冲突。

可选解决方案 #

• 若允许Azure使用开发环境配置：在Azure App Service的配置→应用程序设置中添加ASPNETCORE_ENVIRONMENT = Development，这样Azure会沿用Debug模式的RoutePrefix = "swagger"配置（生产环境不推荐）。
• 修改Azure默认启动URL：在Azure App Service的配置→常规设置里，将启动命令设为dotnet 你的项目.dll --launch-profile=Development，或直接指定启动URL为/swagger。
• 统一配置并手动访问：保持RoutePrefix = "swagger"的统一配置，发布到Azure后手动在URL末尾添加/swagger访问Swagger UI。

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