使用GitHub Actions部署Bicep时参数JSON文件解析失败求助

可能的原因分析 #

1. 容器工作目录不匹配：Azure/cli@v1动作在Docker容器中执行脚本，容器默认工作目录可能与GitHub Actions的仓库根目录不一致，导致找不到指定的参数文件。
2. 路径引用逻辑问题：Bash环境中@符号的解析可能受容器环境影响，相对路径未正确指向文件实际位置。
3. CLI版本兼容性：早期Azure CLI版本（如你最初使用的2.30.0）可能存在参数文件解析bug，虽然后续升级到2.39.0，但问题可能未完全消除。

分步解决办法 #

1. 先验证文件存在性 #

在deploy步骤前添加检查步骤，确认参数文件的位置和存在状态：

- name: Check parameters file
  run: |
    echo "Current working directory: $(pwd)"
    ls -la ./Deployment/

这一步可以帮你确认：

• GitHub Actions的工作目录是否正确指向仓库根目录
• azuredeploy.parameters.json是否确实存在于指定路径下

2. 使用绝对路径引用文件 #

利用GitHub Actions内置的GITHUB_WORKSPACE环境变量（固定指向仓库根目录），替换相对路径为绝对路径：

- name: deploy
  uses: Azure/cli@v1
  with:
    azcliversion: "2.39.0"
    inlineScript: |
      az deployment group create \
        --resource-group my-resource-group \
        --name deploy-${{ github.run_id }} \
        --template-file $GITHUB_WORKSPACE/Deployment/test.bicep \
        --parameters @$GITHUB_WORKSPACE/Deployment/azuredeploy.parameters.json

绝对路径可以彻底避免容器工作目录变化带来的路径匹配问题。

3. 直接传递参数内容（备选方案） #

如果路径问题仍无法解决，可以绕开文件引用，直接将参数内容通过变量传递：

- name: Read parameters file
  id: extract_params
  run: echo "params=$(cat ./Deployment/azuredeploy.parameters.json | jq -c .)" >> $GITHUB_OUTPUT

- name: deploy
  uses: Azure/cli@v1
  with:
    azcliversion: "2.39.0"
    inlineScript: |
      az deployment group create \
        --resource-group my-resource-group \
        --name deploy-${{ github.run_id }} \
        --template-file ./Deployment/test.bicep \
        --parameters '${{ steps.extract_params.outputs.params }}'

注：Ubuntu-latest runner默认已安装jq工具，用于压缩JSON内容。

4. 升级Azure CLI到最新稳定版 #

如果上述方法无效，尝试将azcliversion更新为当前最新稳定版（如2.59.0），新版本通常会修复旧版本的解析bug。

额外注意事项 #

• 确认checkout步骤完整拉取了所有文件，包括Deployment目录内容（你的工作流已启用submodules，需确认submodules中包含该参数文件）。
• 检查参数文件是否存在特殊字符或BOM头，可通过cat -A ./Deployment/azuredeploy.parameters.json命令查看隐藏字符。

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