New-AzServiceBusRule随机报“已存在”错误的解决咨询

问题背景 #

我正在自动化部署应用基础设施，仅在Service Bus的Namespace、Topic、Subscription不存在时才创建它们。由于订阅只需要保留1个规则，所以每次运行脚本时会删除所有现有规则，再重新创建目标规则。

伪代码实现 #

$topic = Get-AzServiceBusTopic -Name $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorVariable notPresent -ErrorAction SilentlyContinue
if ($null -eq $topic -or $notPresent)
{
    $topic = New-AzServiceBusTopic -Name $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorAction Stop
}
$subscription = Get-AzServiceBusSubscription -Name $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorVariable notPresent -ErrorAction SilentlyContinue
if ($null -eq $subscription -or $notPresent)
{
    $subscription = New-AzServiceBusSubscription -Name $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorAction Stop
}
# forcefully delete existing rules
Get-AzServiceBusRule -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName | Remove-AzServiceBusRule
# create rule
$rule = New-AzServiceBusRule -Name "$Default"  -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -FilterType SqlFilter -SqlExpression $SqlFilterExpression -ErrorAction Stop

随机报错信息 #

The messaging entity 'namespacename:Topic:topicname|subscriptionname|$Default' already exists. TrackingId:823eeae9-8776-46e7-90de-5ec305e14bb5_B26, SystemTracker:NoSystemTracker, Timestamp:2023-05-13T10:33:37

根据New-AzServiceBusRule文档，该命令应支持创建或更新现有规则，但实际会随机触发资源已存在的异常，即使删除后等待1秒也无法解决。

问题原因 #

这个随机报错的核心原因是Azure Service Bus的资源操作存在最终一致性延迟：删除规则的请求返回成功后，后台数据同步可能尚未完成，此时立即创建同名的$Default规则，就会触发冲突。固定等待1秒无法覆盖所有环境的同步延迟差异，导致问题随机出现。

另外，$Default作为订阅创建时默认生成的规则，其删除后的状态同步逻辑可能比自定义规则更慢，进一步加剧了这个问题。

解决方案 #

方案1：采用幂等性操作，直接检查并更新/创建规则 #

避免删除所有规则后重建的操作，直接针对$Default规则做存在性检查，存在则更新，不存在则创建：

# 检查目标规则是否存在
$existingRule = Get-AzServiceBusRule -Name "$Default" -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorAction SilentlyContinue

if ($existingRule) {
    # 更新现有规则的过滤条件
    Set-AzServiceBusRule -Name "$Default" -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -FilterType SqlFilter -SqlExpression $SqlFilterExpression -ErrorAction Stop
} else {
    # 创建新规则
    New-AzServiceBusRule -Name "$Default" -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -FilterType SqlFilter -SqlExpression $SqlFilterExpression -ErrorAction Stop
}

这种方式完全规避了删除重建的同步问题，符合基础设施即代码的幂等性要求。

方案2：增强删除后的等待逻辑（需删除所有规则时使用） #

如果业务必须删除所有其他规则，不要固定等待1秒，而是采用循环检查+超时的方式，确认$Default规则确实被删除后再创建：

# 删除所有现有规则
Get-AzServiceBusRule -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName | Remove-AzServiceBusRule -ErrorAction SilentlyContinue

# 循环检查规则是否已删除，最多等待30秒
$timeoutSeconds = 30
$elapsedSeconds = 0
do {
    Start-Sleep -Seconds 1
    $elapsedSeconds++
    $ruleExists = Get-AzServiceBusRule -Name "$Default" -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -ErrorAction SilentlyContinue
} while ($ruleExists -and $elapsedSeconds -lt $timeoutSeconds)

if ($elapsedSeconds -ge $timeoutSeconds) {
    throw "等待$Default规则删除超时，无法继续创建"
}

# 创建新规则
New-AzServiceBusRule -Name "$Default" -SubscriptionName $SubscriptionName -TopicName $TopicName -NamespaceName $NamespaceName -ResourceGroupName $ResourceGroupName -FilterType SqlFilter -SqlExpression $SqlFilterExpression -ErrorAction Stop

该方案能适配不同环境的同步延迟，确保规则删除完成后再执行创建操作。

方案3：直接更新默认规则（最优选择） #

由于$Default是订阅的默认规则，除非有特殊业务需求，完全不需要删除它，直接使用Set-AzServiceBusRule更新其过滤条件即可，彻底规避删除重建的同步问题。

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