GitHub Actions Runner未触发构建：yml文件或Runner问题排查

首先看你的ci-cd.yml文件，存在明确的语法错误，这大概率是导致流程不触发的核心原因：

YAML文件的错误点 #

• run步骤的多行命令格式错误：GitHub Actions中，多行run命令必须用|或>标记换行，否则会被解析为无效语法，直接导致整个Workflow无法被识别。你当前的Build with Maven步骤写法不符合规范，修正后应为：

  - name: Build with Maven
    run: |
      cd Backend/hellopeople
      mvn test
  

• 产物路径可能不匹配：你在Backend/hellopeople目录执行mvn test，如果Maven构建产物存放在该目录的target下，那么path: Backend/target/*.jar会找不到文件。不过这个错误属于构建后阶段，不会直接导致Runner不启动流程，但也需要修正。

Runner异常的排查方向 #

如果修正YAML语法后仍无法执行，再排查Runner本身的问题：

• 检查自托管Runner状态：在仓库的Settings→Actions→Runners页面，确认Runner处于**在线（Active）**状态，未被暂停或离线。
• 确认标签匹配：你的Job指定了runs-on: self-hosted，要确保Runner确实带有self-hosted标签，没有其他标签限制导致无法匹配。
• 查看Runner日志：在Runner安装目录的_diag文件夹中查看日志，排查是否存在连接失败、权限不足等异常。
• 验证仓库权限：确认自托管Runner已被授权访问当前仓库，未被移除或权限受限。

总结：优先修正YAML文件的语法错误（尤其是多行命令格式），这是最可能导致流程不启动的原因。修正后仍有问题，再排查Runner的状态与配置。

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