Azure Serverless方案negotiate时如何动态指定SignalR Hub名称

以下是常见的Azure Functions SignalR negotiate函数硬编码实现：

using Microsoft.AspNetCore.Http;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;

namespace TheNameSpace
{
    public static class Function
    {
        [FunctionName("Negotiate")]
        public static SignalRConnectionInfo Negotiate(
            [HttpTrigger(AuthorizationLevel.Anonymous, Route = "v1/Negotiate")] HttpRequest req,
            [SignalRConnectionInfo(HubName = "serverless")] SignalRConnectionInfo connectionInfo)
        {
            return connectionInfo;
        }
    }
}

该实现可正常运行，但HubName为硬编码配置，无法在请求触发时动态调整，需要实现从请求参数（如req.Query）读取HubName值、动态指定连接对应Hub的效果。

声明式的[SignalRConnectionInfo]特性参数为固定常量，无法在运行时动态赋值，使用命令式绑定即可实现动态HubName的需求，无需额外引入第三方依赖，和原有实现的返回结构完全兼容，客户端无需做适配修改。

可直接参考以下实现代码：

using Microsoft.AspNetCore.Http;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;
using System.Threading.Tasks;

namespace TheNameSpace
{
    public static class Function
    {
        [FunctionName("Negotiate")]
        public static async Task<SignalRConnectionInfo> Negotiate(
            [HttpTrigger(AuthorizationLevel.Anonymous, Route = "v1/Negotiate")] HttpRequest req,
            Binder binder)
        {
            // 从Query参数读取动态HubName，可按需替换为从Header、请求体等位置读取
            string hubName;
            if (!req.Query.TryGetValue("hubName", out var hubNameValues) || string.IsNullOrWhiteSpace(hubNameValues))
            {
                // 按需处理参数缺失场景：返回400错误、指定默认Hub均可
                hubName = "serverless";
            }
            else
            {
                hubName = hubNameValues.ToString();
            }

            // 运行时动态构造连接信息绑定特性
            var connectionInfoAttribute = new SignalRConnectionInfoAttribute
            {
                HubName = hubName,
                // 多实例场景可在此动态指定ConnectionStringSetting对应配置项
                // ConnectionStringSetting = "YourSignalRConnKey"
            };

            // 动态绑定获取对应Hub的连接信息
            var connectionInfo = await binder.BindAsync<SignalRConnectionInfo>(connectionInfoAttribute);
            return connectionInfo;
        }
    }
}

注意事项 #

• 请确保项目引用的Microsoft.Azure.WebJobs.Extensions.SignalRService包版本≥1.2.0，低版本存在命令式绑定兼容性问题
• 读取传入的HubName参数时建议增加合法性校验，避免非法参数触发运行时异常
• 如果部署环境配置了多个SignalR服务实例，可在构造SignalRConnectionInfoAttribute时动态指定ConnectionStringSetting属性，实现服务实例的动态切换

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