Azure YAML Pipeline中Deployment Job的pool.demands配置失效问题

变量解析时机差异 #

普通Job和Deployment Job的变量解析时机不一样，Deployment Job对pool.demands的解析更早——如果你的AgentName是运行时动态生成的（比如来自前序Job输出、延迟加载的变量组），Deployment Job会在变量还没完全赋值时就去匹配Agent，自然找不到符合条件的，就会抛出无描述报错。

语法要求更严格 #

Deployment Job对pool.demands的格式校验比普通Job严得多。如果你用的是运行时变量写法$(AgentName)，大概率会出问题——因为demands属于Pipeline的静态配置部分，运行时变量在这个阶段还没被解析，系统根本识别不了。

试试换成编译时变量的写法：

pool:
  demands: Agent.Name -equals ${{ variables.AgentName }}

${{ }}会在Pipeline初始化阶段就把变量替换成实际值，能被Deployment Job的pool配置正确识别。

环境配置冲突 #

如果你的Deployment Job关联了环境（environment），环境本身可能已经配置了Agent池的约束，和你加的pool.demands叠在一起后，没有Agent能同时满足两个条件，也会导致报错。去环境配置页面看看，有没有预设的Agent池或demands规则，调整一下确保兼容。

快速验证步骤 #

1. 先确认变量没问题：在Deployment Job里加个步骤输出变量值，比如

steps:
- script: echo $(AgentName)

移除demands后能正常输出，说明变量本身是有效的，问题出在demands的配置上。
2. 硬编码测试：把变量换成具体的AgentName，比如

pool:
  demands: Agent.Name -equals MyTestAgent

如果能正常跑，那就是变量解析的问题，换${{ variables.AgentName }}写法就行。
3. 检查环境配置：如果用了environment，去看看环境里有没有Agent池的限制，和你的demands会不会冲突。

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