Windows10环境VS Code调试Python38 Azure Function App遇ECONNREFUSED 9091错误

• 检查端口9091占用情况
  打开命令提示符，执行netstat -ano | findstr :9091，查看是否有进程占用该端口。如果有，用taskkill /F /PID <进程ID>强制结束占用进程，再重新启动调试。

• 强制指定或更换调试端口
  在VS Code的.vscode/launch.json中修改调试配置，指定端口或更换为其他端口：

  {
    "name": "Python: Azure Functions",
    "type": "python",
    "request": "attach",
    "port": 9091, // 可改为9092等未占用端口
    "preLaunchTask": "func: host start"
  }
  

  同时在local.settings.json中添加端口配置（如果更换端口）：

  {
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true", 
      "FUNCTIONS_WORKER_RUNTIME": "python",
      "PYTHON_DEBUG_PORT": "9092" // 与launch.json中port保持一致
    }
  }
  

• 确认虚拟环境与依赖兼容性

  1. 检查VS Code左下角状态栏的Python版本，确保激活的是目标Python3.8虚拟环境。
  2. 在虚拟环境中执行pip install azure-functions==1.17.0 azure-functions-worker==1.21.0，安装与Python3.8兼容的固定版本依赖。

• 临时关闭防火墙或安全软件
  关闭Windows Defender防火墙或第三方安全软件，测试调试是否正常。如果恢复正常，需在防火墙中添加规则，允许func.exe和Python进程通过指定端口通信。

• 清理调试环境与进程

  1. 打开任务管理器，结束所有func.exe、python.exe、vscode.exe相关进程。
  2. 删除.vscode目录下的launch.json和tasks.json，重新通过VS Code的Azure Functions扩展生成调试配置。

• 核对Core Tools版本
  执行func --version查看当前版本，建议使用v4.x版本（与Python3.8兼容）。若版本不合适，用npm安装指定版本：

  npm install -g azure-functions-core-tools@4 --unsafe-perm true
  

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