Azure Service Bus队列触发函数未触发，消息流入死信队列排查

一、Service Bus队列函数不触发&消息进入死信的原因及修复 #

1. 权限配置问题 #

Azure Service Bus连接字符串必须具备至少「监听（Listen）」权限。如果你的连接字符串只有发送权限，函数无法读取队列消息，消息会因多次重试失败进入死信：

• 登录Azure门户，找到目标Service Bus的「共享访问策略」，确认你配置的策略勾选了Listen权限；
• 本地调试时，核对local.settings.json里的ServiceBusConnectionString是带有监听权限的完整连接字符串。

2. 消息序列化/反序列化失败 #

函数直接接收TaskModel类型，若发送的消息格式不匹配，会触发反序列化失败，最终导致消息进入死信：

• 检查消息发送端代码，确保发送的是TaskModel正确序列化后的内容（比如标准JSON格式）；
• 临时修改函数接收原始字符串，先排查消息内容是否符合预期：

  public async Task Run([ServiceBusTrigger("mysbqueue", Connection = "ServiceBusConnectionString")] string rawMessage, ILogger log)
  {
      log.LogInformation("原始消息内容: " + rawMessage);
      try
      {
          var myQueueItem = System.Text.Json.JsonSerializer.Deserialize<TaskModel>(rawMessage);
          await _taskRepository.UpdateTask(myQueueItem);
      }
      catch(Exception ex)
      {
          log.LogError("反序列化或处理错误: " + ex.Message);
      }
  }
  

• 确认TaskModel类有无参构造函数，且属性的名称、类型和消息字段完全匹配（JSON反序列化默认大小写敏感，除非额外配置忽略大小写）。

3. 依赖注入异常 #

函数构造函数注入了ITaskRepository，如果该依赖初始化失败（比如数据库连接错误、未正确注册），会导致函数实例化失败，无法处理消息：

• 检查函数项目的Program.cs，确认ITaskRepository的实现类已正确注册：

  builder.Services.AddScoped<ITaskRepository, TaskRepository>();
  

• 查看函数日志（Azure门户「监控>日志」或本地调试控制台输出），排查是否有依赖注入相关的错误提示。

4. 队列配置问题 #

• 检查队列的死信规则：是否设置了过低的最大重试次数或超时时间，导致消息提前进入死信；
• 确认Azure Service Bus中的队列名称mysbqueue完全匹配（大小写敏感），不存在拼写错误。

二、本地调试断点无法命中（无符号加载）的解决 #

1. 调试模式与项目构建 #

• 右键函数项目>「属性」>「生成」，确认当前配置是Debug而非Release；
• 执行「清理解决方案」后再「重新生成解决方案」，确保符号文件（.pdb）正常生成。

2. 符号加载设置 #

• 在Visual Studio中打开「调试>选项>符号」，勾选「Microsoft符号服务器」（如需加载微软官方库符号），同时确认本地符号路径包含项目bin/Debug/net6.0目录；
• 调试时打开「模块」窗口（调试>窗口>模块），找到函数项目的dll文件，若符号未加载，右键选择「加载符号」，手动指向项目Debug目录下的pdb文件。

3. 函数宿主进程问题 #

• 本地调试时确保函数宿主（func.exe）是通过Debug模式启动；
• 关闭所有Visual Studio实例，重新打开项目并启动调试，避免进程占用导致符号无法加载。

内容的提问来源于stack exchange，提问作者The Inquisitive Coder