如何在Azure Functions v4 Node.js中实现Signal R连接？

我之前在Node.js v4模型的函数应用里成功跑通了SignalR的negotiate和消息推送功能，给你列几个关键的配置和踩过的坑：

• host.json核心配置
  必须在host.json中启用SignalR扩展，注意v4模型的配置层级和旧版不同：

  {
    "$schema": "https://schema.management.azure.com/schemas/2021-06-01/Microsoft.Web.JavaScriptFunctionHost.json",
    "extensions": {
      "signalR": {
        "enabled": true
      }
    },
    "version": "4.0"
  }
  

• Negotiate函数的正确写法
  不能用传统HTTP触发，要使用v4模型提供的SignalR专用绑定：

  const { app } = require('@azure/functions');
  
  app.signalR('negotiate', {
    handler: async (context) => {
      // 可根据实际需求设置用户ID和分组
      return {
        userId: context.req.headers.get('x-ms-client-principal-id') || 'guest',
        groups: ['default-group']
      };
    },
    returnType: 'application/json'
  });
  

  这个函数的路由默认是/api/negotiate，客户端会自动调用它获取连接凭证。

• 消息推送（Posts）的实现
  通过SignalR输出绑定从其他函数推送消息，比如一个HTTP触发的消息发送接口：

  const { app } = require('@azure/functions');
  
  app.http('sendMessage', {
    methods: ['POST'],
    handler: async (context) => {
      const requestBody = await context.req.json();
      // 推送消息到指定客户端或分组
      context.extraOutputs.set('signalR', {
        target: 'receiveMessage', // 客户端监听的方法名
        arguments: [requestBody.content], // 传递给客户端的参数
        // 可选：指定推送的用户或分组
        // userId: 'specific-user-id',
        // groupName: 'default-group'
      });
      return { status: 200, body: '消息已推送' };
    },
    extraOutputs: [app.signalROutput({ hubName: 'your-hub-name' })]
  });
  

• 客户端连接注意事项
  使用@microsoft/signalr库连接时，要注意函数应用的路由和权限验证：

  import * as signalR from '@microsoft/signalr';
  
  const connection = new signalR.HubConnectionBuilder()
    .withUrl('/api', {
      // 如果函数启用了密钥验证，需要提供API密钥
      accessTokenFactory: () => process.env.FUNCTION_API_KEY
    })
    .build();
  
  // 监听服务端推送的消息
  connection.on('receiveMessage', (content) => {
    console.log('收到消息:', content);
  });
  
  await connection.start();
  

• 常见问题排查

  • 确认Azure门户中函数应用的「扩展」选项卡已安装SignalR扩展
  • 检查应用设置中是否配置了正确的AzureSignalRConnectionString
  • 查看函数日志（Azure门户或本地调试日志），定位negotiate或推送请求的报错信息
  • 确保函数的路由规则没有覆盖SignalR的默认路径

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