Azure Queue Trigger函数调用异常：门户发送正常，代码调用未触发

首先明确：SendMessageAsync是正确的队列消息发送方法，消息成功入队后理应触发Queue Trigger函数。你遇到的问题核心是本地调试环境的配置与消息发送目标不匹配，而非调用方式错误。以下是针对性的排查和修正方案：

1. 对齐本地触发器与发送代码的连接字符串 #

本地调试Azure Functions时，触发器依赖local.settings.json中的配置项，必须确保：

• 发送代码里的Myconnection连接字符串值，和local.settings.json中同名配置完全一致
• 如果你的Queue Trigger绑定使用的是默认的AzureWebJobsStorage，则发送代码的连接字符串也必须指向同一个存储账户（或模拟器）

示例local.settings.json配置：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "你的存储连接字符串或UseDevelopmentStorage=true",
    "Myconnection": "与发送代码完全一致的连接字符串"
  }
}

同时确认Queue Trigger的绑定明确指定了连接字符串名称：

[FunctionName("EmailSenderQueueTrigger")]
public static async Task Run(
    [QueueTrigger("myQueueName", Connection = "Myconnection")] string message,
    ILogger log)
{
    log.LogInformation($"处理队列消息: {message}");
    // 发送邮件逻辑
}

2. 检查本地触发器的监听状态 #

启动本地Function项目后，查看控制台输出，确认是否成功监听目标队列。正常日志应包含：

[信息] 触发器已启动并正在监听队列 'myQueueName' (连接字符串 'Myconnection')。

如果没有这条日志，说明触发器绑定存在问题（比如队列名称拼写错误、连接字符串未配置）。

3. 确保队列名称完全匹配 #

检查发送代码中的myQueueName与触发器绑定的队列名称完全一致（Azure存储队列名称不区分大小写，但本地调试时严格匹配可避免意外问题）。

4. 排查本地存储环境差异 #

如果你使用Azure Storage Emulator本地调试：

• 确认模拟器正在运行，且发送代码的连接字符串为UseDevelopmentStorage=true
• 若发送代码指向的是生产环境存储账户，消息会进入生产队列，本地触发器自然无法捕获

优化后的消息发送代码（可选） #

你的原代码逻辑没问题，可补充队列存在性检查和资源释放：

try
{
    string connectionString = "Myconnection";
    string queueName = "myQueueName";
    
    using var queueClient = new QueueClient(connectionString, queueName);
    // 确保队列存在（首次发送会自动创建，显式创建更稳妥）
    await queueClient.CreateIfNotExistsAsync();
    var response = await queueClient.SendMessageAsync("MyMessage");
    Console.WriteLine($"消息发送成功，ID: {response.Value.MessageId}");
}
catch (Exception ex)
{
    Console.WriteLine($"发送失败: {ex.Message}");
    throw;
}

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