.NET 7独立进程Azure Function在VS Code本地调试报错排查

遇到这个问题的核心原因是调试时使用的gRPC通道URI格式不合法（缺少主机名，比如http://:63205），可以按以下步骤逐一排查：

• 检查launchSettings.json配置
  打开项目根目录下的launchSettings.json，找到applicationUrl或相关gRPC端口配置项，确保地址格式是完整的http://localhost:xxxx或http://127.0.0.1:xxxx，而不是http://:xxxx。例如将错误配置：

  "applicationUrl": "http://:63205"
  

  修改为：

  "applicationUrl": "http://localhost:63205"
  

• 校验VS Code调试配置（launch.json）
  打开.vscode/launch.json，检查调试配置中的参数：

  • 确认program指向的是正确的编译后dll路径
  • 检查args中是否传递了错误的gRPC地址参数，避免覆盖默认的合法URI配置
  • 如果是自动生成的调试配置，尝试删除后重新生成（VS Code会根据项目配置自动创建）

• 检查local.settings.json的运行时配置
  确认local.settings.json中FUNCTIONS_WORKER_RUNTIME设置为dotnet-isolated，同时检查是否存在自定义的gRPC端口配置（比如FUNCTIONS_GRPC_PORT），确保端口值是有效数字，且没有在其他地方生成缺失主机名的URI。

• 清理缓存并重新构建

  • 删除项目下的bin和obj目录，执行dotnet build重新编译
  • 关闭VS Code后重启，必要时可以通过Ctrl+Shift+P执行Developer: Reload Window重载窗口清除工作区缓存

• 对齐Azure Functions Core Tools版本
  命令行func start正常但VS Code调试异常，可能是两者使用的Core Tools版本不一致：

  • 用命令行执行func --version查看全局版本
  • 在VS Code中打开设置（Ctrl+,），搜索Azure Functions: Core Tools Path，确认路径指向的是和命令行相同版本的func.exe，如果不一致，手动指定正确路径

• 检查Program.cs中的自定义配置
  如果在Program.cs中手动配置了WebHost的Urls或gRPC服务地址，确保没有写成http://:xxxx的格式，必须包含主机名（比如localhost）。例如：

  var builder = WebApplication.CreateBuilder(args);
  builder.WebHost.UseUrls("http://localhost:63205");
  

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