Blazor WebAssembly 托管部署的 URL 重写异常

Question

在开发过程中，我在 Blazor WebAssembly 应用程序的服务器端使用了 Swagger。始终使用 kestrel 而不是 IIS Express 启动（调试）。 路由按预期工作，我的所有组件都正确路由，如果我手动输入 /swagger，我会进入 swagger 页面。都很好。

我们已经在 IIS 下部署在我们的 pre-prod 服务器上，服务器端和 Blazor WebAssembly 应用程序（客户端）按预期工作并且可用，但是，我的 /swagger url 被重写（我假设）到我的应用程序的某个地方而不是让它去 Swagger，显然没有任何组件可以响应 /swagger。

我唯一的猜测是，当托管在 IIS 上时，aspnet 核心应用程序负责告诉 IIS 重写什么以及如何重写（类似于可以通过 web.config 为“独立”部署提供的配置。）

我找不到如何指定例外，我一直在关注文档 https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/blazor/webassembly?view=aspnetcore-3.1#iis

知道如何为 /swagger 添加例外吗？

编辑：

事实证明它在 Chrome 中没有问题，只有 Firefox 有不需要的行为。如果我清除缓存或使用隐身模式，Firefox 不会出现此问题。因此，Firefox 似乎缓存了一些内容并尝试将我的 URL 输入发送到 Blazor Wasm，而不是通过服务器发送。我将使用开发工具进行更多调试，并打开 fiddler 以尝试解决问题，并将报告回来。

Answer 1

原来这是已发布的 service-worker.js 文件的一部分。它在开发中与发布的不同（这是有道理的）。

在调试期间，无论是否处于隐身/私人模式，我都能在所有浏览器（Edge、Chrome 和 Firefox）上重现该问题。

一旦 service-worker 运行，它就会处理来自 Blazor WebAssembly 应用的 cache/index.html 的服务请求。

如果您进入 Blazor WebAssembly 客户端“wwwroot”文件夹，您会找到一个 service-worker.js 和一个 service-worker.published.js。在 service-worker.published.js 中，你会发现一个看起来像这样的函数：

async function onFetch(event) {
    let cachedResponse = null;
    if (event.request.method === 'GET') {
        // For all navigation requests, try to serve index.html from cache
        // If you need some URLs to be server-rendered, edit the following check to exclude those URLs
        const shouldServeIndexHtml = event.request.mode === 'navigate'
            && !event.request.url.includes('/connect/')
            && !event.request.url.includes('/Identity/');

        const request = shouldServeIndexHtml ? 'index.html' : event.request;
        const cache = await caches.open(cacheName);
        cachedResponse = await cache.match(request);
    }

    return cachedResponse || fetch(event.request);
}

只需按照代码 cmets 中的说明进行操作即可解决问题。所以我们最终像这样为“/swagger”添加了一个排除项：

&& !event.request.url.includes('/swagger')

希望这篇文章对那些想要在 Service Worker 之外提供服务的人有用，而不仅仅是 Swagger。

Answer 2

您的 Startup.Configure 方法中是否首先使用 UseSwagger？

public static void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "YourAppName V1")
    );

在 Startup.ConfigureServices 我最后有 Swagger 代码。

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();
    services.AddSwaggerGen(c =>
        c.SwaggerDoc(
            name: "v1",
            info: new OpenApiInfo
            {
                Title = "YourAppName",
                Version = "V1",
            }));
}

这对我们来说效果很好。

注意：您必须导航到https://yourdomain/swagger/index.html