Azure DevOps Webhook触发Pipeline后无法获取Payload字段内容

核心问题原因 #

你遇到的问题是因为System.AreaPath字段名包含英文点号，YAML会将点号默认解析为属性层级分隔符，直接使用.System.AreaPath会被错误识别为访问fields.System下的AreaPath属性，而非fields字典中键为System.AreaPath的值。

解决方案 #

方法1：使用索引器语法直接访问 #

在YAML表达式中，对带点的键使用方括号索引器来访问，避免YAML解析错误。修改后的PowerShell任务代码如下：

trigger:
  none
pool:
  name: SYNCCHR

resources:
  webhooks:
    - webhook: GETPAYLOAD          
      connection: GETPAYLOAD_CON 

steps:
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      # 直接获取基础属性
      Write-Host "工作项ID: ${{ parameters.GETPAYLOAD.resource.workItemId }}"
      Write-Host "修订版本号: ${{ parameters.GETPAYLOAD.resource.revision.rev }}"
      
      # 使用索引器获取带点的字段值
      Write-Host "区域路径: ${{ parameters.GETPAYLOAD.resource.revision.fields['System.AreaPath'] }}"

方法2：将Payload转为PowerShell对象灵活处理 #

如果需要批量获取多个属性，更推荐将整个Webhook Payload转为PowerShell对象，之后可以自由访问任意属性，无需关注字段名是否带点：

trigger:
  none
pool:
  name: SYNCCHR

resources:
  webhooks:
    - webhook: GETPAYLOAD          
      connection: GETPAYLOAD_CON 

steps:
- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      # 将Webhook Payload转为JSON字符串，再解析为PowerShell对象
      $webhookPayloadJson = '${{ convertToJson(parameters.GETPAYLOAD) }}'
      $webhookPayload = $webhookPayloadJson | ConvertFrom-Json -Depth 10

      # 自由访问任意属性
      Write-Host "工作项ID: $($webhookPayload.resource.workItemId)"
      Write-Host "修订版本号: $($webhookPayload.resource.revision.rev)"
      Write-Host "区域路径: $($webhookPayload.resource.revision.fields.'System.AreaPath')"
      # 示例：获取其他带点字段，比如System.Title
      Write-Host "工作项标题: $($webhookPayload.resource.revision.fields.'System.Title')"

说明：

• convertToJson(parameters.GETPAYLOAD)是Azure DevOps内置表达式，用于将参数对象转为JSON字符串
• 使用ConvertFrom-Json -Depth 10确保深层嵌套的JSON结构能被完整解析
• 在PowerShell中访问带点的键时，用单引号包裹键名即可：$obj.fields.'System.AreaPath'

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