Angular v20.2新SSR架构下使用AngularNodeAppEngine无法返回404状态码的问题

看起来你遇到的问题主要来自两个核心点：serverRoutes的匹配顺序错误，以及内部路由导航时SSR不会自动更新响应状态码。我来一步步帮你解决：

1. 先修正serverRoutes的匹配顺序 #

你当前的serverRoutes里把**通配符路由放在了404路由前面，这会导致所有请求（包括/404）都会先被**匹配到，你的404状态码配置根本没机会生效。Angular的serverRoutes是按从上到下的顺序匹配的，所以必须把精确匹配的路由放在通配符前面：

// app.routes.server.ts
import { RenderMode, ServerRoute } from '@angular/ssr';
export const serverRoutes: ServerRoute[] = [
  // 先匹配精确的404路径，确保配置优先生效
  { 
    path: '404', 
    renderMode: RenderMode.Server, 
    status: 404, 
    headers: { 'Cache-Control': 'no-cache' } 
  },
  // 再匹配所有其他路径
  { 
    path: '**', 
    renderMode: RenderMode.Server 
  }
];

这样当用户直接访问/404时，服务器会正确触发404状态码和对应的响应头配置。

2. 处理内部路由导航到404的情况 #

当你用this.router.navigateByUrl('/404')（不管有没有skipLocationChange）进行内部路由跳转时，这属于应用内部的路由变化，而非初始请求匹配到对应路径。这种情况下，serverRoutes里的status配置不会生效，因为初始请求已经被处理完毕了。

你需要在AppNotFoundComponent中手动修改服务器响应的状态码，用Angular SSR提供的RESPONSE注入Token：

// not-found.component.ts
import { Component, OnInit, Inject, PLATFORM_ID } from '@angular/core';
import { isPlatformServer } from '@angular/common';
import { RESPONSE } from '@angular/ssr';
// 导入express的Response类型（对应你用的express服务器）
import type { Response } from 'express';

@Component({
  selector: 'app-not-found',
  templateUrl: './not-found.component.html'
})
export class AppNotFoundComponent implements OnInit {
  constructor(
    @Inject(PLATFORM_ID) private platformId: Object,
    // RESPONSE在客户端环境下是null，所以设为可选类型
    @Inject(RESPONSE) private response: Response | null
  ) {}

  ngOnInit(): void {
    // 仅在服务器环境下修改响应，避免客户端报错
    if (isPlatformServer(this.platformId) && this.response) {
      this.response.status(404);
      this.response.setHeader('Cache-Control', 'no-cache');
    }
  }
}

这样不管是用户直接访问/404，还是通过应用内部导航到404页面，在SSR渲染时都会正确返回404状态码。

3. 额外验证点 #

• 确认app.config.server.ts中withRoutes(serverRoutes)的配置正确（你当前的配置没问题，重点保证serverRoutes的顺序正确即可）。
• 测试初始请求：直接在浏览器访问/404，用开发者工具的网络面板检查响应状态码和Cache-Control头是否符合预期。
• 测试内部导航：从其他页面通过路由跳转到404，同样用网络面板查看服务器返回的状态码（建议用隐私模式或禁用缓存测试，避免客户端缓存干扰）。

这样调整后，应该就能彻底解决你遇到的404状态码不生效的问题了。

内容来源于stack exchange