Jenkins waitUntil步骤异常：Permission Set Groups更新后仍循环等待

1. 类型不匹配导致判断失效 #

这是最常见的触发原因：通过sh步骤执行SOQL查询返回的结果是字符串类型，如果直接和数字0做相等判断，会因为类型不匹配返回false，导致waitUntil一直循环。

比如你的代码可能存在这类问题：

def count = sh(script: "...", returnStdout: true).trim()
return count == 0 // 字符串"0"和数字0不相等，永远返回false

解决方法：

• 把count转为数字后比较：return count.toInteger() == 0
• 直接用字符串做匹配：return count == "0"
• 更可靠的方式是用JSON格式返回查询结果，解析totalSize字段（原生数字类型）：

  def queryJson = sh(script: "sfdx force:data:soql:query -q \"SELECT Id FROM PermissionSetGroup WHERE Status = 'Updating'\" -r json", returnStdout: true)
  def count = new groovy.json.JsonSlurper().parseText(queryJson).totalSize
  return count == 0
  

2. waitUntil 返回逻辑写反 #

waitUntil的核心规则是：重复执行闭包，直到闭包返回true才会退出等待。如果你的判断逻辑写反了——比如本来要等count == 0，却写成了return count != 0——那永远不会满足退出条件。

解决方法：
检查闭包的return语句，确保逻辑是「当目标状态达成时返回true」。比如你需要等待Updating记录为0，就返回count == 0。

3. 查询语句或上下文错误 #

• SOQL语句错误：检查字段名是否正确（比如PermissionSetGroup的标准Status字段不要误写为Status__c）、WHERE条件的枚举值是否准确（'Updating'的大小写要匹配Salesforce的枚举值）。
• 环境/权限不一致：确认Jenkins执行sfdx命令的用户有PermissionSetGroup对象的读取权限，且操作的环境（沙盒/生产）和你手动验证的环境一致。如果用户权限不足，可能查询不到真实的记录数。

4. 变量作用域问题 #

如果查询操作放在了waitUntil闭包外面，会导致每次循环都复用第一次的查询结果，而不是获取最新数据。

错误示例：

def count = sh(script: "...", returnStdout: true).trim() // 只执行一次查询
timeout(time: 30, unit: 'MINUTES') {
    waitUntil {
        echo "Count: ${count}"
        return count == "0" // 永远用第一次的结果
    }
}

解决方法：
将查询逻辑放在waitUntil闭包内部，确保每次循环都重新执行查询，获取最新的记录数。

5. Salesforce数据延迟或缓存 #

有时候Permission Set Groups的后台更新已经完成，但Salesforce的查询节点可能存在缓存，导致查询结果未及时更新。

解决方法：
在每次查询前添加短暂的sleep，避免频繁查询触发缓存：

waitUntil {
    sleep(time: 20, unit: 'SECONDS') // 等待20秒再查询
    def queryJson = sh(script: "...", returnStdout: true)
    def count = new groovy.json.JsonSlurper().parseText(queryJson).totalSize
    return count == 0
}

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