Angular项目Karma测试执行完成后进程不自动关闭的解决方法

ng test默认开启watch监听模式，测试执行完成后会持续驻留进程监听文件变更，用于本地开发时代码修改自动重测，不会主动退出进程，该默认逻辑和CI流水线要求的“执行完成后返回对应状态码退出”的规则不匹配。
从提供的执行日志看，测试用例本身已经全部执行成功，仅因为默认配置未开启单次运行模式导致进程挂起。

方案1：命令行追加参数（最快适配CI场景） #

在原有测试命令后追加关闭监听、开启单次运行的参数，完整命令如下：

ng test --include='src/app/shared/components/primary-auto-complete/primary-auto-complete.component.spec.ts' --watch=false --browsers=ChromeHeadless --single-run

参数说明：

• --watch=false：关闭Angular CLI默认的文件变更监听
• --single-run：通知Karma在所有测试用例执行完成后，直接关闭浏览器实例、终止进程，根据测试结果返回对应退出码：全部用例通过返回0（流水线判定成功），存在失败用例返回非0值（流水线判定失败）

方案2：固化CI专用配置（适合项目长期维护） #

修改项目根目录下angular.json文件，在对应项目的test节点下新增CI专属配置，避免每次执行命令都重复追加参数：

1. 找到路径projects > [你的项目名称] > architect > test > configurations，新增如下配置段：

"ci": {
  "watch": false,
  "browsers": "ChromeHeadless",
  "singleRun": true
}

2. CI环境中执行测试时，直接调用该配置即可：

ng test --configuration=ci --include='src/app/shared/components/primary-auto-complete/primary-auto-complete.component.spec.ts'

如果追加上述参数后进程依然挂起，检查两类常见问题：

• 测试用例中存在未清理的异步任务：比如未销毁的setInterval/setTimeout定时器、未取消的RxJS订阅、未移除的DOM事件监听，这类残留异步句柄会阻止Node进程正常退出，需要在afterEach或afterAll钩子中统一清理
• 检查项目根目录下karma.conf.js的自定义配置，若存在手动将singleRun设为false、autoWatch设为true的规则，需要调整为CI环境下的正确值。

内容的提问来源于stack exchange，提问作者Van Wilder