.NET Core+Angular单页项目npm start启动失败求助

问题背景 #

严格按照微软官方指南创建的.NET Core结合Angular单页应用，Windows 11系统下开启HTTPS运行时出现报错，Visual Studio输出日志如下：

The thread '[Thread Destroyed]' (82028) has exited with code 0 (0x0).
Microsoft.AspNetCore.SpaProxy.SpaProxyLaunchManager: Error: Couldn't start the SPA development server with command 'npm start'.
The thread '[Thread Destroyed]' (77016) has exited with code 0 (0x0).
The thread '[Thread Destroyed]' (76840) has exited with code 0 (0x0).
The thread '[Thread Destroyed]' (79908) has exited with code 0 (0x0).
The thread '[Thread Destroyed]' (64088) has exited with code 0 (0x0).
The thread '[Thread Destroyed]' (80724) has exited with code 0 (0x0).
The program '[68072] 3dPrintProject.Server.exe' has exited with code 4294967295 (0xffffffff).

已排查版本兼容性问题，仍无法正常运行和构建项目。

排查与修复步骤 #

• 先验证前端项目独立启动能力
  打开终端进入Angular项目根目录（通常是ClientApp文件夹），执行以下命令：

  npm install
  npm start
  

  若前端启动失败，根据终端输出的具体错误修复（比如依赖安装失败、端口被占用、HTTPS证书未信任等）。

• 核对SpaProxy与Angular的HTTPS配置

  1. 编辑项目根目录Properties/launchSettings.json，确认HTTPS相关配置：

     "profiles": {
       "https": {
         "commandName": "Project",
         "launchBrowser": true,
         "environmentVariables": {
           "ASPNETCORE_ENVIRONMENT": "Development",
           "ASPNETCORE_URLS": "https://localhost:5001;http://localhost:5000"
         },
         "applicationUrl": "https://localhost:5001;http://localhost:5000",
         "dotnetRunMessages": true
       }
     }
     

  2. 打开Angular项目的angular.json，确保serve配置开启SSL且端口与后端代理匹配：

     "serve": {
       "builder": "@angular-devkit/build-angular:dev-server",
       "options": {
         "browserTarget": "3dPrintProject:build",
         "ssl": true,
         "port": 44443 // 需和SpaProxy配置的前端端口一致
       }
     }
     

• 信任本地HTTPS证书
  以管理员身份启动PowerShell，执行以下命令信任.NET和Angular的本地开发证书：

  # 信任.NET HTTPS开发证书
  dotnet dev-certs https --trust
  # 安装Angular CLI并信任其HTTPS证书
  npm install -g @angular/cli
  ng dev-certs https --trust
  

• 检查端口占用
  使用PowerShell检查后端和前端端口是否被其他进程占用：

  # 检查后端HTTPS端口（示例5001）
  netstat -ano | findstr :5001
  # 检查前端HTTPS端口（示例44443）
  netstat -ano | findstr :44443
  

  若端口被占用，可杀死对应进程或修改launchSettings.json、angular.json中的端口号。

• 修复SpaProxy依赖
  卸载并重新安装SpaProxy NuGet包，确保依赖版本正确：

  dotnet remove package Microsoft.AspNetCore.SpaProxy
  dotnet add package Microsoft.AspNetCore.SpaProxy
  

内容的提问来源于stack exchange，提问作者Simone Negro