发布Python Azure函数提示Not a vso image pip install异常排查

执行func azure functionapp publish <function> --python命令发布Python版Azure函数应用时，发布流程显示远程构建成功，但pip install依赖安装步骤无实际执行效果，部署后函数运行触发模块找不到类报错，发布日志中出现提示Not a vso image, so not writing build commands。

Not a vso image, so not writing build commands不是报错，和依赖安装失效没有直接关联。这条输出是Oryx构建引擎的常规环境判断逻辑：仅当构建运行在Azure DevOps专用的VSO构建镜像上时，才会输出流水线可识别的格式化构建命令；当前运行在函数应用的Kudu构建环境中，跳过该步骤属于正常行为，不是构建失败的标志。

• 依赖声明文件不符合要求
  Oryx执行Python构建时，默认读取项目根目录下的requirements.txt安装依赖。如果该文件不存在、内容格式错误、编码异常，或者被.funcignore规则排除在上传压缩包之外，会出现pip进程启动后没有实际安装任何包的情况。排查时首先确认项目根目录存在格式合法的requirements.txt，且.funcignore中没有配置排除该文件的规则。
• 本地上传文件存在路径冲突
  发布流程会自动清理远程旧的.python_packages目录，但如果本地项目中提前存在.python_packages、虚拟环境目录（venv/.venv）、__pycache__缓存目录，且没有被.funcignore排除，这些文件会被一并上传到构建环境，干扰Oryx的依赖安装路径判断，导致安装完成的依赖没有被打入最终发布包。排查时检查.funcignore规则，确保本地虚拟环境、缓存目录被忽略，发布前手动删除本地残留的.python_packages目录后重试。
• 函数应用构建配置错误
  如果函数应用的部署配置关闭了部署时构建、或者Python版本配置不匹配，会导致构建流程空跑。需要在函数应用的配置项中确认以下参数：
  • SCM_DO_BUILD_DURING_DEPLOYMENT值为true，确保部署时触发构建动作
  • FUNCTIONS_WORKER_RUNTIME值为python，匹配函数运行时
  • LinuxFxVersion指定的Python大版本和本地开发、requirements.txt中声明的版本兼容
• pip安装过程静默失败
  默认构建日志不会输出pip安装的详细过程，存在网络超时、依赖包编译失败、私有源访问鉴权失败等错误被日志吞掉的可能。可以在应用配置中添加SCM_TRACE_LEVEL=verbose开启详细构建日志，重新发布后查看pip安装的完整输出定位具体错误；也可以通过Kudu进入应用实例，直接查看完整的构建日志文件内容。

如果需要快速定位问题边界，可以在发布命令中添加--build local参数，在本地完成依赖安装、打包全流程后直接上传发布包，跳过远程Oryx构建环节。如果本地构建发布后函数可以正常运行，即可确认问题出在远程构建的配置或环境环节。

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