Angular 17启用SSR与预渲染后执行ng build报Invalid URL错误求助

我创建了一个启用SSR（服务端渲染）与PreRender（预渲染）的Angular 17新项目，执行ng build命令时返回如下错误：

An unhandled exception occurred: Invalid URL
See "C:\Users\hjort\AppData\Local\Temp\ng-DWGMVS\angular-errors.log" for further details.

日志文件内容：

[error] TypeError [ERR_INVALID_URL]: Invalid URL
at new NodeError (node:internal/errors:405:5)
at new URL (node:internal/modules/esm/resolve:821:16)
at moduleResolve (node:internal/modules/esm/resolve:1034:11)
at defaultResolve (node:internal/modules/esm/hooks:832:28)
at nextResolve (node:internal/modules/esm/hooks:277:30)
at Hooks.resolve (node:internal/modules/esm/loader:337:35)
at ModuleLoader.resolve (node:internal/modules/esm/loader:220:38)
at ModuleLoader.getModuleJob (node:internal/modules/esm/loader:307:34)
at ModuleLoader.import (node:internal/modules/esm/hooks:138:51)

原本自动生成的app.routes.ts为空，我尝试添加路由后问题仍未解决：

export const routes: Routes = [
 {
    title: 'Titel här',
    path: '',
    component: AppComponent
 }
];

可能的解决步骤 #

• 检查Node.js版本
  Angular 17要求Node.js版本≥18.13.0，低版本Node在ESM模块解析URL时易出现异常。执行node -v查看版本，若不达标，升级至18.x或20.x LTS版本。

• 修正路由配置逻辑
  不要将根组件AppComponent作为路由组件使用，需创建独立子组件（如HomeComponent）作为路由目标，同时在app.component.html中添加<router-outlet></router-outlet>用于渲染路由组件。修改后的app.routes.ts示例：

import { Routes } from '@angular/router';
import { HomeComponent } from './home/home.component';

export const routes: Routes = [
  {
    title: 'Titel här',
    path: '',
    component: HomeComponent
  }
];

• 排查配置文件中的URL参数
  检查angular.json里server、prerender配置段的options，确保baseUrl、deployUrl、预渲染路由列表等参数格式合法，无拼写错误或非法字符。

• 清理缓存后重新构建
  执行以下命令清除缓存并重建依赖：

ng cache clean
# Windows系统执行：del /s /q node_modules && del package-lock.json
# macOS/Linux系统执行：rm -rf node_modules package-lock.json
npm install
ng build

• 检查server.ts的URL处理逻辑
  确认server.ts中涉及URL构造的代码（如APP_BASE_HREF注入、路由初始化）符合URL规范，无错误拼接或非法参数。

内容的提问来源于stack exchange，提问作者Björn Hjorth