Github Action传递路径数组时收到空字符串的问题求助

核心问题分析 #

你遇到的错误是两个问题叠加导致的：

1. Detect-spec-file job输出的repo-path为空字符串，让matrix无法解析
2. 即使输出了正确的JSON数组，matrix也需要通过fromJson解析才能识别为数组格式

逐步修复步骤 #

1. 替换git log为git diff，获取可靠的变更文件列表 #

GitHub Actions默认的actions/checkout@v2是浅克隆（仅拉取最新commit），git log -m -1在这种场景下可能无法正确获取提交的变更文件。改用git diff来获取当前提交的变更文件更可靠：

git diff HEAD^ HEAD --name-only > output.txt

如果是首次提交（没有HEAD^），可以提前拉取足够的历史避免报错：

if [ $(git rev-parse --is-shallow-repository) = "true" ]; then
  git fetch --depth=2
fi
git diff HEAD^ HEAD --name-only > output.txt

2. 修正文件路径匹配逻辑，避免正则错误 #

你用的grep -i 'path/to/file/*'存在正则语法问题：grep默认是正则模式，*表示匹配前面字符的零次或多次，而非shell通配符的“任意字符”。直接用git diff的路径过滤更高效准确：

# 直接在git diff时过滤路径，省去grep步骤
git diff HEAD^ HEAD --name-only -- 'path/to/file/*' > specpath.txt

如果需要不区分大小写匹配，再用grep处理：

git diff HEAD^ HEAD --name-only | grep -i 'path/to/file/' > specpath.txt

3. 修复wc -l的输出格式 #

wc -l specpath.txt会输出行数 文件名（比如2 specpath.txt），导致spec_file_count不是纯数字。改用重定向输入的方式只获取行数：

SPEC_COUNT=$(wc -l < specpath.txt)

4. 确保JQ输出有效的JSON数组（即使为空） #

当没有匹配到文件时，array是空的，需要确保JQ输出[]而非空字符串。可以优化JQ的调用逻辑，省去循环赋值数组的步骤：

# 直接从specpath.txt读取内容生成JSON数组
echo "path=$(jq -R . specpath.txt | jq -cs )" >> "$GITHUB_OUTPUT"

这样即使specpath.txt为空，也会输出[]，而非空字符串。

5. 在matrix中用fromJson解析数组 #

GitHub Actions的输出变量是字符串类型，需要用fromJson将JSON字符串解析为数组，才能被matrix识别：

matrix: 
  spec-file: ${{ fromJson(needs.Detect-spec-file.outputs.repo-path) }}

完整修正后的Workflow代码 #

jobs:
  Detect-spec-file:
    runs-on: [ubuntu-latest]
    outputs:
      repo-path: ${{ steps.spec-file-change.outputs.path }}
      path-count: ${{ steps.spec-file-change.outputs.spec_file_count }}

    steps:
    - name: Checkout Repository
      uses: actions/checkout@v2
      with:
        fetch-depth: 2 # 拉取足够的提交历史，避免HEAD^不存在的问题

    - name: Detect Spec File
      id: spec-file-change
      run: |
        # 获取当前提交的变更文件并过滤路径
        git diff HEAD^ HEAD --name-only | grep -i 'path/to/file/' > specpath.txt
        
        # 统计匹配的文件数量
        SPEC_COUNT=$(wc -l < specpath.txt)
        echo "spec_file_count=$SPEC_COUNT" >> "$GITHUB_OUTPUT"
        
        # 生成JSON格式的路径数组
        echo "path=$(jq -R . specpath.txt | jq -cs )" >> "$GITHUB_OUTPUT"
       
  Lint-spec-file:
    needs: Detect-spec-file
    runs-on: [ubuntu-latest]
    # 只有当有匹配文件时才运行该Job
    if: ${{ needs.Detect-spec-file.outputs.path-count != '0' }}
    strategy:
      max-parallel: 1
      matrix: 
        spec-file: ${{ fromJson(needs.Detect-spec-file.outputs.repo-path) }}

额外建议 #

• 加上if条件判断，当path-count为0时跳过Lint-spec-file job，避免不必要的执行
• 使用actions/checkout@v4替代v2，获取更好的兼容性和性能

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