Azure Function本地开发调试失败求助：Python运行时启动异常

1. 环境依赖兼容性校验 #

• 确认Azure Function Core Tools版本：终端执行func --version，Python 3.10.11需搭配v4.x版本的Core Tools（推荐v4.0.4915及以上），v3.x版本存在Python 3.10兼容性问题。
• 验证Python包依赖：终端执行python -m pip list，确保azure-functions包版本≥1.11.0，缺失则执行pip install azure-functions。
• 锁定VS Code的Python解释器：点击左下角状态栏的Python版本，确认选中重装后的3.10.11环境，避免误选系统其他Python版本。

2. 端口与进程冲突排查 #

• 检查端口占用：Windows终端执行netstat -ano | findstr :53444，Mac/Linux执行lsof -i :53444，若有其他进程占用该端口，杀死对应PID的进程后重试。
• 排除安全软件拦截：临时关闭Windows Defender防火墙或第三方杀毒软件，测试是否能正常连接；若恢复正常，将VS Code和func.exe添加到安全软件信任列表。

3. 项目配置文件检查 #

• 修正local.settings.json：确保FUNCTIONS_WORKER_RUNTIME设为python，AzureWebJobsStorage可暂时设为UseDevelopmentStorage=true（未安装存储模拟器时也可留空，不影响基础HTTP触发调试）。
• 核对.vscode/launch.json：确认program路径指向Core Tools的func.exe（Windows默认路径为%APPDATA%\npm\node_modules\azure-functions-core-tools\bin\func.exe），args配置为["host", "start"]，且env字段中PYTHONPATH指向项目根目录。

4. Python工作进程超时（错误码-1073741819）处理 #

• 该错误为Windows内存访问异常，多由环境依赖冲突导致：
  • 创建独立虚拟环境：项目根目录执行python -m venv .venv，激活虚拟环境后重新安装依赖pip install -r requirements.txt。
  • 清理缓存文件：删除项目下的.venv、__pycache__文件夹，以及local.settings.json中的FUNCTIONS_WORKER_PROCESS_ID等临时配置项。
• 延长工作进程启动超时：在local.settings.json中添加"FUNCTIONS_WORKER_TIMEOUT": "60"（单位：秒），增加启动等待时长。

5. Core Tools重置与手动启动验证 #

• 重装Core Tools：终端执行npm uninstall -g azure-functions-core-tools，再以管理员权限执行npm install -g azure-functions-core-tools@4 --unsafe-perm true（Windows需管理员身份打开终端）。
• 手动启动测试：跳过VS Code调试按钮，在项目根目录执行func host start，观察终端输出的详细错误信息；若手动启动成功，再切换回VS Code调试模式。

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