azure webjobs 默认仅预装 python 2.7 和 3.4，无法直接运行基于 python 3.9 的脚本；本文详解通过手动部署便携版 python 3.9、配置环境变量及调整启动脚本，实现在 webjobs 中稳定运行 python 3.9 应用的完整方案。

azure webjobs 默认仅预装 python 2.7 和 3.4，无法直接运行基于 python 3.9 的脚本；本文详解通过手动部署便携版 python 3.9、配置环境变量及调整启动脚本，实现在 webjobs 中稳定运行 python 3.9 应用的完整方案。

Azure WebJobs 运行于 App Service 的沙箱环境中，其内置 Python 版本长期未更新（截至当前仍为 2.7/3.4），而现代 Python 项目普遍依赖 3.8+ 特性（如 typing.Literal、zoneinfo）或第三方库（如 pydantic v2、httpx）对高版本解释器的硬性要求。因此，不能依赖系统预装 Python，必须显式引入并调用自定义 Python 3.9 运行时。

✅ 推荐方案：部署便携版 Python 3.9（Windows 环境）

Azure App Service（Windows）支持 ZIP 部署，且允许执行本地二进制文件，因此推荐使用官方提供的 Windows embeddable package（zip 格式） —— 它无需安装、无注册表依赖、开箱即用：

1. 下载并解压 Python 3.9
   访问 python.org/downloads → 下载 Windows embeddable package (64-bit)（例如 python-3.9.19-embed-amd64.zip）。
   解压后重命名文件夹为 python39，并将整个目录上传至 WebApp 的 site/wwwroot/ 路径下（可通过 ZIP 部署、Kudu Console 或 DevOps Pipeline 实现）。

2. 配置 PATH 环境变量（可选但推荐）
   登录 Azure 门户 → 进入 App Service → Configuration → General settings → Path mappings → 在 PATH 变量中追加：

   %HOME%\site\wwwroot\python39

   ⚠️ 注意：%HOME% 在 Windows App Service 中解析为 D:\home，确保路径大小写与实际一致（Windows 不敏感，但建议统一小写）。

   

   A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

   调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

   下载

3. 编写健壮的 WebJob 启动脚本（run.cmd）
   在 WebJob 根目录（如 site/wwwroot/App_Data/jobs/triggered/myjob/）下创建 run.cmd，内容如下：

   @echo off
   setlocal enabledelayedexpansion
   
   :: 显式设置 Python 路径（优先级高于 PATH）
   set PYTHON_HOME=%HOME%\site\wwwroot\python39
   set PATH=%PYTHON_HOME%;%PATH%
   
   :: 验证 Python 版本（日志可见）
   echo [INFO] Using Python from: %PYTHON_HOME%
   python --version
   
   :: 激活虚拟环境（若使用 .venv，需修正 pyvenv.cfg 中的 home 路径）
   if exist "%HOME%\site\wwwroot\.venv\Scripts\activate.bat" (
       call "%HOME%\site\wwwroot\.venv\Scripts\activate.bat"
   )
   
   :: 执行主脚本（建议使用绝对路径）
   python "%HOME%\site\wwwroot\my_script.py"
   
   exit /b %ERRORLEVEL%

   ? 关键点说明：

   立即学习“Python免费学习笔记（深入）”；

   • 不要依赖 .venv/pyvenv.cfg 中原始 home = C:\... 路径（本地开发路径无效），WebJob 中应直接调用 python.exe 并确保其位于 PATH 前置位置；
   • 若坚持使用虚拟环境，需在部署前用脚本批量替换 pyvenv.cfg 中的 home 行为：home = D:\home\site\wwwroot\python39；
   • 使用 python（而非 python3.9.exe）即可，因 python39/ 目录下已包含 python.exe 符号链接（embeddable 包自带）。

? 补充建议与注意事项

• 避免使用 MSI 安装包：WebJobs 无管理员权限，无法执行传统安装程序；
• 注意位数匹配：务必选择 amd64（非 win32）版本，App Service Windows 实例默认为 64 位；
• 依赖库部署：将 requirements.txt 中的包通过 pip install -t site/wwwroot/lib 安装到共享目录，或直接打包 .venv（需提前修正 pyvenv.cfg）；
• 调试技巧：在 run.cmd 中加入 dir %PYTHON_HOME% 和 python -c "import sys; print(sys.path)" 快速定位路径问题；
• 长期演进提示：Azure 已在部分新区域支持 Python 3.11（通过 Linux App Service + Custom Container），如需长期维护，建议评估迁移至 Linux + Docker 方案以获得更灵活的运行时控制。

通过以上步骤，你即可在 Azure WebJobs 中可靠运行 Python 3.9 应用，彻底摆脱系统旧版本限制。