Azure Service Bus发送消息时通用错误的排查与解决

你遇到的通用错误同时出现在代码和Azure门户，说明问题大概率出在服务总线资源本身的配置或状态上，以下是针对性排查步骤：

1. 检查服务总线命名空间状态 #

• 登录Azure门户，进入你的服务总线命名空间，查看概览页的资源状态，确认没有欠费、禁用或部署未完成的提示。如果命名空间处于异常状态，所有操作都会失败。

2. 核查队列核心配置 #

• 确认队列处于启用状态：进入队列的概览页，检查顶部状态标识是否为"已启用"。
• 验证队列基本属性：检查队列名称是否和你使用的完全一致（注意无空格、特殊字符拼写错误），分区、重复检测等配置是否符合预期（刚创建的队列默认配置通常没问题，但需确认未被误修改）。

3. 验证权限与连接字符串 #

• 确认主连接字符串的权限：主连接字符串关联的RootManageSharedAccessKey默认拥有所有权限，但需检查是否被手动修改过权限范围，确保包含发送权限。
• 核对连接字符串内容：确保连接字符串中的命名空间名称与实际资源名称完全匹配，无拼写或大小写错误（Azure资源名称不区分大小写，但连接字符串需准确）。

4. 排查网络隔离配置 #

• 检查虚拟网络（VNet）设置：如果命名空间配置了VNet隔离，需确认是否开启了"允许受信任的Azure服务访问此命名空间"，否则门户和本地客户端都无法访问。
• 核查防火墙规则：如果设置了IP防火墙，需确认你的本地IP地址或Azure门户的IP地址已加入允许列表（可临时关闭防火墙测试，确认是否是此原因）。

5. 检查资源配额 #

• 进入服务总线命名空间的配额页，查看队列数量、消息总数、吞吐量单位（高级层）等指标是否已达到上限，刚创建的资源通常不会出现，但需排除此可能。

6. 查看详细错误日志 #

• 进入服务总线命名空间的活动日志，筛选报错时间点的操作记录，查看是否有更具体的错误描述（比如权限拒绝、资源限制等），这是定位系统级错误的关键。

代码侧额外检查（仅供参考） #

虽然门户也报错，但仍可确认代码的正确性：

• 确保使用的是最新稳定版Azure.Messaging.ServiceBus NuGet包，避免使用旧版Microsoft.Azure.ServiceBus。
• 对比以下标准发送代码，确认你的实现无逻辑错误：

using Azure.Messaging.ServiceBus;
using System;

namespace ServiceBusTest
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string connectionString = "你的主连接字符串";
            string queueName = "你的队列名称";

            await using var client = new ServiceBusClient(connectionString);
            ServiceBusSender sender = client.CreateSender(queueName);

            try
            {
                var message = new ServiceBusMessage("测试消息内容");
                await sender.SendMessageAsync(message);
                Console.WriteLine("消息发送成功");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"发送失败: {ex.Message}");
            }
        }
    }
}

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