Python版Azure Functions无法通过Azure Pipeline部署的问题求助

问题分析 #

本地和VS Code部署正常，但Azure DevOps管道部署后触发器不显示、API无法访问，且文件已上传，核心原因大概率是依赖包未被正确打包到部署文件中，导致函数运行时无法加载必要模块，进而无法初始化触发器。

具体解决步骤 #

1. 修正构建管道的依赖安装路径 #

原构建脚本中，pip install的目标目录是当前工作目录下的.python_packages，但后续打包的是Solutions/FunctionApp目录，导致依赖包未被包含在部署压缩包内。修改bash步骤的安装路径：

pip install --target="./Solutions/FunctionApp/.python_packages/lib/site-packages" -r ./Solutions/FunctionApp/requirements.txt

完整的bash步骤应为：

if [ -f extensions.csproj ]
then
    dotnet build extensions.csproj --output ./Solutions/FunctionApp/bin
fi
pip install --target="./Solutions/FunctionApp/.python_packages/lib/site-packages" -r ./Solutions/FunctionApp/requirements.txt

2. 确认Azure Function App的Python版本与构建一致 #

在Azure门户的Function App配置中，进入配置 > 常规设置，确保Python版本设置为3.11，与构建管道中指定的版本匹配。

3. 验证部署包内容 #

构建完成后，可在Azure DevOps的构建 artifacts中下载压缩包，检查是否包含.python_packages目录及其中的依赖文件（如matplotlib、azure.functions）。

4. 查看函数运行日志排查初始化错误 #

即使门户未显示报错，也可通过以下方式查看日志：

• 进入Function App的日志流，查看实时运行日志
• 访问Kudu控制台（https://<your-function-app-name>.scm.azurewebsites.net），在LogFiles/runtime目录下查看函数初始化日志，通常能找到模块缺失的错误信息

补充说明 #

VS Code部署会自动处理Python函数的依赖打包逻辑，将依赖安装到函数目录下的.python_packages并一同上传，而Azure DevOps构建需要手动指定正确的路径才能实现相同效果。

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