Azure Functions SignalRTrigger函数本地调试断点未触发问题求助

问题 #

我正在按照一个SignalR双向聊天示例构建首个带SignalR触发绑定的Azure Function App，已在Azure上完成Function App和SignalR服务的部署配置。现在需要调试其中一个SignalR触发函数，尝试通过Visual Studio 2022的本地函数主机（func.exe）启动调试（按下F5）。

我编写了包含JoinGroup函数的ServerlessHub代码，期望在Visual Studio中触发该函数并命中断点：

namespace FunctionApp
{
    public class SimpleChat : ServerlessHub
    {
        [FunctionName("negotiate")]
        public SignalRConnectionInfo Negotiate([HttpTrigger(AuthorizationLevel.Anonymous)]HttpRequest req)
        {
            var claims = GetClaims(req.Headers["Authorization"]);
            return Negotiate(
                claims.First(c => c.Type == ClaimTypes.NameIdentifier).Value,
                claims
            );
        }

        [FunctionName(nameof(JoinGroup))]
        public async Task JoinGroup([SignalRTrigger]InvocationContext invocationContext, string connectionId, string groupName)
        {
            throw new ApplicationException("CODE REACHED");
            await Groups.AddToGroupAsync(connectionId, groupName);
        }
    }
}

同时编写了一个TypeScript客户端，通过以下方法调用JoinGroup函数：

testjoinGroup(){
    if (this.isConnected()) {
        this.hubConnection.invoke<any>("joinGroup", "testGroupName")
            .then(x => console.log("success"))
            .catch(err => console.log(err));
    }
}

客户端连接创建成功，negotiate请求正常完成，调用testjoinGroup()时打印“success”，但Visual Studio中的断点始终未命中，且Web应用和VS均未报错。我已配置local.settings.json连接到Azure上的SignalR实例。

请问这种本地调试是否不可行？是否必须将代码部署到Azure才能测试新功能？

环境信息：

• 安装了Azure开发工作负载的Visual Studio 2022
• .NET 6版本
• 使用Microsoft.Azure.Webjobs.Extenions.SignalRServicce 1.8.0

解决思路与方案 #

本地调试SignalR触发的Azure Function完全可行，无需必须部署到Azure。你的问题大概率是本地函数主机未正确接收Azure SignalR服务的触发事件，以下是具体排查和解决步骤：

1. 修正local.settings.json配置 #

确保配置包含正确的SignalR连接参数和服务模式：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "AzureSignalRConnectionString": "<你的Azure SignalR连接字符串>",
    "AzureSignalRServiceMode": "Serverless"
  }
}

• 确认AzureSignalRConnectionString是从Azure门户复制的完整连接字符串
• 必须显式设置AzureSignalRServiceMode为Serverless，否则本地主机无法处理Serverless模式下的触发事件

2. 修正SignalR触发函数签名 #

你的JoinGroup函数存在两处关键问题：

• SignalRTrigger需要指定对应Hub名称（即你的ServerlessHub类名SimpleChat），修改后：

  [SignalRTrigger("SimpleChat")]
  

• 客户端调用的方法名是小写joinGroup，但函数的FunctionName是大写开头的JoinGroup，两者必须一致。要么修改客户端调用为JoinGroup，要么修改函数的FunctionName为"joinGroup"

3. 确保客户端连接本地函数端点 #

如果客户端当前连接的是Azure上部署的Function App的negotiate端点，触发的会是云端的函数实例，而非本地主机。需要让客户端连接本地函数主机的negotiate端点（通常是http://localhost:7071/api/negotiate），这样Azure SignalR服务才会将触发事件转发到本地调试环境。

4. 检查本地函数主机日志 #

启动调试后，查看Visual Studio的“输出”窗口（选择“Azure Functions”输出源），确认：

• SignalR扩展初始化成功的日志记录
• 客户端调用方法时，是否有函数触发的日志输出
  如果无触发日志，说明连接字符串或服务模式配置错误，导致Azure SignalR服务无法转发事件到本地

5. 修正NuGet包名称 #

你使用的包名存在拼写错误，正确包名为Microsoft.Azure.WebJobs.Extensions.SignalRService。建议升级到与.NET 6兼容的最新稳定版本，避免版本兼容性问题。

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