GitHub Actions解压tgz脚本运行异常及触发问题求助

遇到的问题 #

• 推送操作（无论tgz还是非tgz文件）无法触发工作流
• 手动触发工作流后，没有执行解压操作，也无任何报错信息
• 已将actions/setup-node更新至v4，但仍收到「Node.js 16 actions已弃用」的警告
• 反复调整脚本后，src目录未创建、tgz文件未解压

我使用的脚本代码 #

name: Unpack TGZ
on:
  push:
    paths:
      - '*.tgz'
  workflow_dispatch:

jobs:
  unpack:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - name: Unpack TGZ
        run: |
          mkdir -p src
          tar -xzf *.tgz -C src

问题排查与修复方案 #

1. 推送无法触发工作流 #

• 确认工作流文件路径：必须放在仓库的.github/workflows/目录下，文件后缀为.yaml或.yml
• 调整paths匹配规则：如果tgz文件不在仓库根目录，'*.tgz'无法匹配，改为'**/*.tgz'可匹配所有子目录中的tgz文件
• 检查分支权限：确认推送的分支未被分支保护规则限制，若工作流指定了branches范围，需确保推送分支在范围内

2. 手动触发无解压操作且无报错 #

• 验证文件是否存在：添加步骤打印当前目录文件，确认tgz文件已被拉取到执行环境：

- name: 检查当前目录文件
  run: ls -la

• 修复tar命令适配特殊文件名：如果tgz文件名包含空格或特殊字符，直接使用*.tgz可能失效，改为遍历匹配文件更稳妥：

- name: 解压TGZ文件
  run: |
    mkdir -p src
    for tgz_file in *.tgz; do
      if [ -f "$tgz_file" ]; then
        tar -xzf "$tgz_file" -C src
        echo "已解压 $tgz_file 到src目录"
      else
        echo "未找到tgz文件"
      fi
    done

• 拉取完整仓库内容：actions/checkout默认仅拉取最新提交（fetch-depth: 1），若tgz是新推送的文件可能未被拉取，修改为：

- uses: actions/checkout@v4
  with:
    fetch-depth: 0

3. Node.js 16弃用警告仍存在 #

• 更新所有依赖的Action：除actions/setup-node外，像actions/checkout旧版本（如v3）底层依赖Node.js 16，需将所有使用的Action更新至最新稳定版（如checkout用v4）
• 定位警告来源：查看工作流日志中的警告详情，找到具体触发警告的Action，针对性更新该Action

验证步骤 #

1. 修改脚本后手动触发工作流，查看「检查当前目录文件」步骤的输出，确认tgz文件存在
2. 查看「解压TGZ文件」步骤的执行日志，确认命令正常执行
3. 推送一个tgz文件到仓库根目录，检查工作流是否自动触发

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