AWS CodePipeline构建步骤中ng lint/ng test冻结挂起如何解决？

问题特征 #

• AWS CodePipeline中绑定的Angular项目构建任务，运行满1小时固定抛出BUILD_TIMEOUT错误导致流水线失败
• 翻查构建日志可见，末尾执行的ng lint命令已经输出执行成功的提示，但始终没有将控制权交还给bash进程，构建步骤卡在该位置不再往下执行
• 单独排查ng test命令存在相同问题：测试用例全部执行完成、日志输出成功结果后进程冻结挂起，无法正常退出，最终耗尽构建超时时间

问题根因 #

这个问题是Angular CLI默认配置和CI非交互环境不兼容导致的：

• 面向本地开发场景设计的ng lint在部分版本中，检查完成后不会主动退出进程，默认等待文件变更触发重新检查
• ng test默认开启watch模式，用例执行完成后会常驻监听文件改动，没有显式传参关闭watch的情况下，就算在CI环境也不会主动退出
• ng test启动的Headless Chrome实例如果没有配置退出规则，测试跑完后浏览器进程残留，会导致主进程一直等待子进程回收，持续挂起

AWS CodeBuild的构建环境属于无TTY的非交互环境，Angular CLI无法自动识别CI场景切换到单次执行模式，就会出现「日志显示成功但进程卡死」的现象，直到触发1小时的全局构建超时。

修复方法 #

给对应命令追加CI环境专用参数，强制执行完成后立即退出进程：

1. 调整ng lint命令，追加--exit参数，强制lint检查完成后直接终止进程：

   ng lint --exit
   

2. 调整ng test命令，显式关闭watch模式，指定无头浏览器执行，关闭进度条输出避免异常：

   ng test --watch=false --browsers=ChromeHeadless --no-progress
   

3. 兜底配置（可选）：如果加完参数仍存在偶发挂起，可以在buildspec.yml中给单条命令设置独立超时，避免耗尽全局1小时的构建配额：

   phases:
     build:
       commands:
         - timeout 300 ng lint --exit # 给lint步骤设置5分钟独立超时
         - timeout 600 ng test --watch=false --browsers=ChromeHeadless --no-progress # 给测试步骤设置10分钟独立超时
   

验证方式 #

本地先通过非交互模式验证命令退出逻辑正常：执行bash -c "ng lint --exit; echo $?"，确认命令执行完能正常输出返回码，不会卡住。之后提交代码触发CodePipeline运行，确认两个命令执行完成后构建步骤能正常推进，不会卡在命令位置直到超时。

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