ASP.NET Core 2.1 中的 UseStaticFiles、UseSpaStaticFiles 和 UseSpa 有什么区别？

Question

ASP.NET Core 2.1.1 为 appBuilder 提供了几个看似相关的扩展方法：

• UseStaticFiles 来自Microsoft.AspNetCore.StaticFiles
• UseSpaStaticFiles 来自Microsoft.AspNetCore.SpaServices.Extensions
• UseSpa 来自Microsoft.AspNetCore.SpaServices.Extensions

请帮助我理解他们的目的和彼此之间的关系？

另外，如果我以不同的顺序运行这些方法，从服务器执行的角度来看有什么不同

例如

app.UseStaticFiles() -> app.UseSpaStaticFiles() -> app.UseSpa()

对

app.UseSpa() -> app.UseSpaStaticFiles() -> app.UseStaticFiles()

Answer 1

静态文件，例如 HTML、CSS、图像和 JavaScript，是一种资产 ASP.NET Core 应用程序直接服务于客户端。一些配置是 需要启用这些文件的服务。

• UseStaticFiles - 在 Web 根目录（wwwroot 文件夹）内提供文件

• UseSpaStaticFiles - 在资产中提供静态文件，如图像、css、js Angular 应用的文件夹

• UseSpa - 让 asp.net 核心知道您要运行哪个目录 角度应用程序，在生产模式下运行时的 dist 文件夹和 哪个命令在开发模式下运行 Angular 应用程序

例子

services.AddSpaStaticFiles(configuration =>
{
 configuration.RootPath = "ClientApp/dist";
});

app.UseSpa(spa =>
{
    // To learn more about options for serving an Angular SPA from ASP.NET Core,
    // see https://go.microsoft.com/fwlink/?linkid=864501

    spa.Options.SourcePath = "ClientApp";

    if (env.IsDevelopment())
    {
        spa.UseAngularCliServer(npmScript: "start");
    }
});

Answer 2

1. UseStaticFiles 提供来自 wwwroot 的文件，但可以更改。
2. UseSpaStaticFiles 做了类似的事情，但它需要注册 ISpaStaticFileProvider。如果 app.ApplicationServices.GetService() 返回 null，那么你会得到一个异常。

throw new InvalidOperationException($"To use {nameof(UseSpaStaticFiles)}, you must " +
                    $"first register an {nameof(ISpaStaticFileProvider)} in the service provider, typically " +
                    $"by calling services.{nameof(AddSpaStaticFiles)}.");

所以你需要调用app.AddSpaStaticFiles()来注册默认的ISaStaticFileProvider

1. UseSpa 做了两件事。将所有请求重写到默认页面并尝试配置静态文件服务。与 UseSpaStaticFiles 不同，它不会抛出异常，而是退回到 wwwroot 文件夹。

实际上 UseSpaStaticFiles 和 UseSpa 都在内部调用相同的方法 UseSpaStaticFilesInternal 但第三个参数的值不同，即 allowFallbackOnServingWebRootFiles。这就是为什么 UseSpaStaticFiles 在没有注册 ISpaStaticFileProvider 时抛出异常的原因，它根本不允许回退到 wwwroot。

顺便说一句，如果 UseSpa 在内部回退到 wwwroot，它会调用旧的 app.UseStaticFiles(staticFileOptions);

github 资源链接： 1.SpaDefaultMiddleware 2.SpaStaticFilesExtensions