VS Code本地调试Python Azure Function时出现grpc.FutureTimeoutError()

问题背景 #

通过VS Code Azure扩展创建默认配置的Azure Function项目，启动Azurite存储模拟器后本地调试触发grpc.FutureTimeoutError()错误，但代码部署至云端Function App后运行完全正常。测试v1、v2版本项目均出现相同本地调试问题，函数代码为向导默认生成。

可行解决方案 #

1. 排查Azurite端口占用 #

• 打开VS Code的Azurite扩展设置，确认Blob/Queue/Table服务的默认端口（10000/10001/10002）未被其他进程占用
• 若存在端口冲突，修改Azurite的端口配置，重启模拟器后重新调试

2. 延长本地函数运行超时时间 #

在项目根目录的local.settings.json中添加超时配置，示例：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "python",
    "FUNCTIONS_WORKER_RUNTIME_TIMEOUT": "300"
  }
}

修改后保存，重启本地调试会话。

3. 更新相关工具与扩展 #

• 卸载并重新安装最新版本的Azure Functions Core Tools
• 将VS Code中的Azurite扩展更新至最新版，重启VS Code后重新启动Azurite

4. 重置Azurite存储数据 #

• 停止Azurite模拟器，删除默认数据存储目录：%USERPROFILE%\.azurite（Windows）或~/.azurite（Mac/Linux）
• 重新启动Azurite，让其重新初始化存储环境

5. 同步Python依赖版本 #

• 检查本地Python环境的grpcio、azure-functions包版本，更新至与云端兼容的稳定版本：

pip install --upgrade azure-functions grpcio

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