配置GitHub Actions跨仓库执行E2E测试时工作流挂起问题排查

问题根源 #

npm start 默认是前台运行的阻塞进程，会一直占用当前Shell的执行上下文，导致后续步骤无法触发——这和本地需要新开命令行窗口运行后续操作的逻辑完全一致。

修复方案 #

需要将应用改为后台运行，并确保服务完全就绪后再执行测试。以下是调整后的Workflow配置：

steps:
  - name: 检出被测源码
    uses: actions/checkout@v2

  - name: 安装应用依赖
    run: npm install

  - name: 后台启动本地服务
    run: npm start &

  - name: 等待应用服务就绪
    run: npx wait-on http://localhost:3000

  - name: 检出独立仓库中的E2E测试代码
    uses: actions/checkout@v2
    with:
      repository: <my_username>/<my_e2e_test_repo> 
      path: cypress-tests

  - name: 安装E2E测试依赖
    run: cd cypress-tests && npm install 

  - name: 执行E2E测试
    run: cd cypress-tests && npx cypress run 

关键修改说明：

• 将原合并的npm install && npm start拆分为两步，日志更清晰，避免安装与启动流程互相干扰。
• npm start & 让应用在后台运行，释放当前Shell以执行后续步骤。
• 使用wait-on工具轮询应用服务地址，直到服务正常响应，确保测试执行前应用已完全启动（如果没有安装wait-on，可以在应用依赖中提前添加，或者用npx直接调用）。

额外优化建议 #

1. 如果E2E测试仓库是私有仓库，需要在checkout步骤中添加token参数，比如：

   with:
     repository: <my_username>/<my_e2e_test_repo>
     path: cypress-tests
     token: ${{ secrets.GITHUB_TOKEN }}
   

2. 可以添加actions/cache步骤缓存node_modules，大幅缩短依赖安装时间。

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