Azure Functions中Python版SignalR触发器绑定无法工作求助

核心误解：SignalR触发器的触发条件 #

你的广播函数是从Azure Function向SignalR服务发送消息，这种服务端发送的消息不会触发SignalR触发器。SignalR触发器（category: messages）仅会在客户端向SignalR服务发送消息时被触发。你需要用JS客户端主动调用send方法发送消息，才能触发触发器函数，而非依赖广播函数的输出。

配置与代码修正步骤 #

1. 修正触发器函数的参数解析逻辑 #

在Python中，SignalR触发器的参数是func.SignalRInvocationContext类型，无需手动JSON解析，直接访问属性即可。原代码手动解析会导致类型错误，可能触发失败但无明显日志：

import logging
import azure.functions as func

def main(invocation: func.SignalRInvocationContext) -> None:
    logging.info(f"Receive {invocation.arguments[0]} from {invocation.connection_id}")

2. 调整触发器的event配置 #

event字段需要匹配客户端发送消息时指定的target名称。假设你的JS客户端调用的是connection.send('newMessage', 'xxx')，则function.json中的event应改为newMessage，而非SendMessage：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "type": "signalRTrigger",
      "name": "invocation",
      "hubName": "testhub",
      "connectionStringSetting": "AzureSignalRConnectionString",
      "category": "messages",
      "event": "newMessage",
      "parameterNames": [
          "message"
      ],
      "direction": "in"
    }
  ]
}

3. 验证上游URL配置的正确性 #

在SignalR服务的上游设置中，确保URL和模式匹配：

• URL：必须是Function App的SignalR Webhook地址，格式为：

  https://<你的函数应用名称>.azurewebsites.net/runtime/webhooks/signalr?code=<你的函数主机密钥>
  

  主机密钥可在函数应用的「密钥」->「主机密钥」中获取。
• 模式：需匹配你的hub、category和event，比如：

  testhub/messages/newMessage
  

  若要监听该hub下所有消息事件，可使用通配符模式testhub/messages/*。

4. 测试客户端发送消息 #

修改你的JS客户端代码，添加主动发送消息的逻辑：

// 连接成功后发送测试消息
connection.on('newMessage', (message) => {
  console.log('收到消息:', message);
});

connection.start().then(() => {
  // 主动发送消息触发触发器
  connection.send('newMessage', '来自客户端的测试消息');
}).catch(err => console.error(err));

日志排查建议 #

如果以上修正后仍未触发，查看函数应用的日志：

• 进入函数应用的「日志流」，实时查看触发器的调用记录和错误信息。
• 检查Application Insights中的跟踪日志，确认上游请求是否到达函数应用，以及是否有未捕获的异常。

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