Azure Functions Python v2部署故障：函数无法加载求助

问题诊断 #

从日志和报错信息来看，核心问题集中在以下几点：

• Pillow依赖不完整：报错ImportError: cannot import name '_imaging' from 'PIL'，说明跨平台部署时Pillow缺少Linux环境下的底层编译组件。
• 函数索引失败：日志显示1 functions found, 0 functions loaded，本质是依赖导入失败导致函数无法被正确识别。
• RUN_FROM_PACKAGE路径冲突：启用该选项后函数从只读包运行，.python_packages目录不存在，但部署脚本仍将依赖安装到该路径，导致运行时无法找到依赖。
• Python版本不匹配：Azure环境使用Python 3.10，本地测试用3.6-3.9，版本差异引发依赖兼容性问题。

分步解决方案 #

1. 修复Pillow的跨平台安装问题 #

在Linux环境下，Pillow需要系统依赖库支持，需在部署脚本中添加系统库安装步骤：
在Build阶段的Install application dependencies任务前，新增bash步骤：

sudo apt-get update && sudo apt-get install -y python3-dev libjpeg-dev zlib1g-dev

同时修改pip安装命令，避免缓存并确保安装适配Linux的Pillow版本：

python -m pip install --upgrade pip
pip install --no-cache-dir --target="./.python_packages/lib/site-packages" -r ./requirements.txt

2. 调整RUN_FROM_PACKAGE的依赖部署逻辑 #

启用RUN_FROM_PACKAGE时，需将依赖打包到可访问路径。可将依赖安装到函数根目录的site-packages：
修改pip安装命令的target路径：

pip install --no-cache-dir --target="./site-packages" -r ./requirements.txt

在function_app.py开头添加路径配置，让Python能识别依赖：

import sys
import os
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'site-packages'))

3. 对齐Python版本 #

在Azure门户中配置函数应用的Python版本，与本地测试版本一致：

1. 进入函数应用的配置 -> 常规设置
2. 在Python版本中选择3.9，保存后重启应用

4. 修正hosts文件配置问题 #

Azure无法直接使用本地hosts设置，需将映射配置到应用设置：

1. 进入函数应用的配置 -> 应用程序设置
2. 添加对应域名映射的环境变量（如内部服务需通过VNet或Private Link访问；自定义域名需在Azure完成域名绑定）

验证步骤 #

1. 重新运行部署管道，确认所有步骤执行成功
2. 查看日志流，确认无ImportError和No job functions found报错
3. 检查函数状态，确认显示1 functions loaded
4. 手动触发或等待Timer触发器执行，验证函数运行正常

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