Linux服务器Jenkins运行Cypress无头测试超时问题求助

针对你在普通Linux服务器的Jenkins上运行Angular+Cypress自动化测试遇到的超时问题，我整理了几个实际项目里验证过的排查和解决思路，你可以逐一尝试：

• 先确认Angular服务是否真的启动并可访问
  有时候超时不是因为服务启动慢，而是Jenkins环境下无法正常访问localhost:3030。你可以在Jenkins的Freestyle项目里添加一个前置构建步骤，执行以下命令手动验证：

  # 检查端口是否被监听
  ss -tulpn | grep 3030
  # 尝试请求服务
  curl -v http://localhost:3030
  

  如果curl返回正常的HTTP响应（比如200），说明服务能起来，问题出在start-server-and-test的检测逻辑；如果curl失败，那得先排查Angular服务在Jenkins环境下启动失败的原因（比如端口占用、权限不足）。

• 延长start-server-and-test的超时时间
  默认的超时时间（通常60秒）可能不足以让Angular在Jenkins服务器上完成启动（尤其是服务器资源有限的情况）。你可以修改package.json里的test脚本，显式设置更长的超时：

  "scripts": {
    // 其他脚本...
    "test": "start-server-and-test start http://localhost:3030 cy:run --timeout 120000"
  }
  

  这里把超时设置为120秒（120000毫秒），给服务足够的启动时间。

• 调整wait-on的检测规则
  start-server-and-test底层依赖wait-on，默认的检测逻辑可能对Angular的启动状态判断不准确。你可以指定更明确的检测方式，比如等待特定HTTP路径、调整HTTP超时：

  "test": "start-server-and-test start http-get://localhost:3030 cy:run --httpTimeout 60000"
  

  或者尝试检测Angular的favicon资源（通常加载更早）：

  "test": "start-server-and-test start http://localhost:3030/favicon.ico cy:run"
  

• 检查依赖版本兼容性
  有时候start-server-and-test和cypress的版本不匹配会导致检测异常。你可以尝试更新这两个依赖到稳定版本：

  npm update start-server-and-test cypress
  

  或者参考start-server-and-test的官方文档，选择和当前Cypress版本兼容的固定版本。

• 拆分脚本，手动控制启动流程
  如果start-server-and-test的自动检测始终有问题，你可以拆分测试步骤，手动控制每一个环节：

  1. 在Jenkins构建步骤中添加命令，后台启动Angular服务并记录PID：

     npm run start &
     echo $! > ng-server.pid
     

  2. 使用wait-on手动等待服务就绪：

     npx wait-on http://localhost:3030 --timeout 120000
     

  3. 运行Cypress测试：

     npm run cy:run
     

  4. 最后不管测试结果如何，杀掉Angular服务（避免端口占用）：

     kill $(cat ng-server.pid) || true
     

  这种方式能让你更清晰地看到每一步的日志，方便定位到底是哪环节出了问题。

• 排查Jenkins环境的资源和权限问题
  确认Jenkins的运行用户是否有足够的权限启动服务、监听端口；同时检查服务器的CPU、内存使用率，如果资源不足，Angular启动速度会大幅变慢，导致超时。可以在Jenkins构建前添加top -b -n 1命令查看服务器资源状态。

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