Github Actions跨Job传递Output为空，求排查原因

问题场景 #

在GitHub Actions中尝试将build Job的输出传递到deploy Job，但deploy Job中的输出始终为空，使用的配置文件如下：

name: Stripe Service
on: [ push ]

env:
  AWS_REGION: eu-central-1
  AWS_LAMBDA_FUNCTION_NAME: StripeService
  DEPLOY_TYPE: development

jobs:
  build:
    name: 🔧 Build & Test Image
    runs-on: ubuntu-latest
    outputs:
      image: ${{ steps.build.outputs.image }}

    steps:
      - name: 🔧 Checkout repository
        uses: actions/checkout@v4
      
      - name: ☁ Configure AWS Credentials
        uses: aws-actions/configure-aws-credentials@v1
        with:
          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          aws-region: ${{ env.AWS_REGION }}
      
      - name: ☁ Login to AWS ECR
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v2

      - name: 🔧 ☁ Build & Push Docker Image to AWS ECR
        env: 
          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
          ECR_REPOSITORY: stripe-service
          IMAGE_TAG: ${{ env.DEPLOY_TYPE }}-${{ github.sha }}
        id: build
        run: |
          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
          echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> "$GITHUB_OUTPUT"
  
  deploy:
    name: ☁ Deploy Image to Production (AWS Lambda)
    runs-on: ubuntu-latest
    needs: build

    steps:
      - name: ☁ Deploy Docker Image as AWS Lambda function
        env:
          IMAGE: ${{ needs.build.outputs.image }}
        run: echo "$IMAGE"

核心原因分析 #

输出为空的本质是build Job中负责生成输出的逻辑未正常执行，或生成的输出值本身为空，具体可能的场景包括：

• Docker命令执行失败：GitHub Actions的Run脚本默认启用set -e（遇错误立即终止），如果docker build或docker push执行失败，后续的echo "image=..." >> "$GITHUB_OUTPUT"语句不会执行，导致steps.build.outputs.image无值。
• ECR Registry变量为空：Login to AWS ECR步骤输出的registry值未正确传递，导致拼接的镜像地址为空。
• 变量解析异常：Step级环境变量（如IMAGE_TAG）未被正确解析，导致镜像地址拼接失败。

解决方案 #

1. 添加调试日志定位问题 #

修改build步骤的Run脚本，开启调试模式并输出关键变量，确认每一步的执行状态：

- name: 🔧 ☁ Build & Push Docker Image to AWS ECR
  env: 
    ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
    ECR_REPOSITORY: stripe-service
    IMAGE_TAG: ${{ env.DEPLOY_TYPE }}-${{ github.sha }}
  id: build
  run: |
    set -x  # 开启调试模式，输出所有执行的命令
    echo "ECR Registry: $ECR_REGISTRY"
    echo "Image Tag: $IMAGE_TAG"
    docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
    docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
    echo "Generated image URL: $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG"
    echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> "$GITHUB_OUTPUT"

2. 确保输出逻辑必执行（按需使用） #

如果需要在Docker命令失败时仍生成输出（不推荐用于生产环境），可以关闭set -e或忽略错误：

set +e  # 关闭遇错即停
docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
set -e  # 恢复默认行为
echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> "$GITHUB_OUTPUT"

3. 验证ECR登录输出 #

在Login to AWS ECR步骤后添加验证步骤，确认registry值是否正常：

- name: ☁ Verify ECR Registry
  run: echo "ECR Registry: ${{ steps.login-ecr.outputs.registry }}"

4. 检查Job依赖关系 #

确认deploy Job的needs: build配置正确，确保只有build Job成功执行后才会触发deploy。

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