Linux Azure Function运行报错：无法从lxml导入etree

排查与修复步骤 #

1. 对齐Python运行时版本 #

确认Azure Function的Python运行时版本和本地开发环境完全一致（比如都是3.8/3.9）。可以在函数应用的「配置」→「常规设置」中修改Python版本，版本不匹配可能导致跨平台依赖兼容问题。

2. 强制安装Linux适配的lxml二进制包 #

本地Windows/macOS环境会自动安装对应平台的预编译二进制包，但Linux环境下可能需要显式指定。修改requirements.txt：

python-docx==0.8.11
lxml==4.9.3 --only-binary :all:

或者本地构建依赖时先执行：

pip install --upgrade pip
pip install lxml==4.9.3 --force-reinstall --only-binary :all:
pip freeze > requirements.txt

3. 确保依赖部署完整性 #

• 删除本地venv虚拟环境、__pycache__文件夹，重新生成干净的依赖列表
• 部署时开启函数应用的部署日志，检查lxml安装阶段是否有报错（如缺少编译依赖）
• 如果是使用远程构建，确认Azure的构建环境具备lxml编译所需的系统依赖（如libxml2-dev、libxslt1-dev，不过使用二进制包可规避编译问题）

4. 验证lxml安装路径 #

在函数代码中添加调试代码，输出lxml的安装位置，确认是否加载了正确的包：

import lxml
print(f"lxml path: {lxml.__file__}")

如果路径指向系统Python而非函数的虚拟环境，说明部署时依赖未正确安装到函数隔离环境中。

5. 调整依赖版本组合 #

尝试降级python-docx到0.8.10，或升级lxml到更稳定的版本（如4.9.4），部分版本组合可能存在隐性兼容性冲突。

内容的提问来源于stack exchange，提问作者Mišo