Angular 5 Universal(SSR)结合.NET Core staging服务器I18n工具失效

我正在尝试让基于.NET Core的Angular项目模板搭配Angular I18n工具运行，本地通过Visual Studio的IIS Express运行时，两种语言都正常工作：

• http://localhost:59508/en/ 可正常访问
• http://localhost:59508/fr/ 也能正常打开

但部署到生产服务器后，即使仅配置英文语言映射，项目也完全无法运行。针对这个情况，我整理了几个关键排查方向和解决方案：

1. 确认静态文件服务配置是否正确 #

.NET Core生产环境下必须正确配置静态文件中间件，确保Angular编译后的多语言资源能被服务器正确读取：

• 检查Startup.cs里的静态文件配置，要确保指向Angular编译后的dist文件夹，示例代码如下：

app.UseStaticFiles();
// 自定义静态文件目录配置（如果需要）
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.ContentRootPath, "ClientApp/dist")),
    RequestPath = ""
});

2. 验证Angular生产构建的多语言输出 #

先确认生产构建是否正确生成了对应语言的打包文件：

• 检查你的构建命令是否包含本地化参数，比如：

ng build --prod --localize
# 或者指定特定语言：ng build --prod --localize --locale=en --locale=fr

• 登录生产服务器，查看ClientApp/dist目录下是否有en和fr两个子文件夹，每个文件夹里要有完整的Angular编译文件（比如index.html、main.js等）。

3. 配置URL重写规则解决SPA路由问题 #

Angular是单页应用，生产服务器必须支持URL重写，否则访问/en/这类非根路径刷新时会返回404：

• 如果用.NET Core自带的重写中间件，先安装Microsoft.AspNetCore.Rewrite包，然后在Startup.cs里添加规则：

var options = new RewriteOptions();
// 排除API和静态文件路径，其他请求都重写到index.html
options.AddRewrite(@"^(?!api|static).*$", "/index.html", skipRemainingRules: true);
app.UseRewriter(options);

• 如果服务器是IIS，要确保安装了URL重写模块，同时在项目的web.config里添加重写规则：

<rewrite>
  <rules>
    <rule name="Angular Routes" stopProcessing="true">
      <match url=".*" />
      <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
        <add input="{REQUEST_URI}" pattern="^/(api)" negate="true" />
      </conditions>
      <action type="Rewrite" url="/index.html" />
    </rule>
  </rules>
</rewrite>

4. 调整SPA回退路由的多语言映射 #

要确保.NET Core的路由配置能正确映射到不同语言的Angular入口文件：

• 在Startup.cs里针对不同语言路径配置独立的SPA回退规则，示例如下：

// 处理英文路径
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/en"), app =>
{
    app.UseSpa(spa =>
    {
        spa.Options.SourcePath = "ClientApp";
        spa.Options.DefaultPage = "/en/index.html";
    });
});

// 处理法语路径
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/fr"), app =>
{
    app.UseSpa(spa =>
    {
        spa.Options.SourcePath = "ClientApp";
        spa.Options.DefaultPage = "/fr/index.html";
    });
});

// 默认回退到英文
app.UseSpa(spa =>
{
    spa.Options.SourcePath = "ClientApp";
    spa.Options.DefaultPage = "/en/index.html";
});

5. 检查服务器文件权限 #

最后别忘了确认生产服务器上的应用程序池账户有读取ClientApp/dist及其子文件夹的权限，没有权限的话服务器加载不了静态资源也会导致项目无法运行。

内容的提问来源于stack exchange，提问作者Jean-Francois