Azure Web App（Python）部署失败：pip安装azure-iothub-device-client出错

我之前部署Python应用到Azure Web App时也碰到过类似的特定版本IoT客户端包安装失败的情况，结合你的场景，给你几个实用的排查和解决方向：

1. 对齐本地与Azure的Python版本 #

azure-iothub-device-client 1.3.2对Python版本有严格限制（比如仅支持3.6~3.8版本），如果Azure Web App默认使用的Python版本和你本地不一致，很容易导致安装失败。

解决方法：在项目根目录创建runtime.txt文件，写入和本地一致的Python版本，例如：

python-3.7.9

这样Azure部署时会自动切换到指定版本的Python环境进行依赖安装。

2. 补充编译所需的系统依赖 #

这个包是基于C扩展开发的，Azure Linux Web App的默认环境缺少编译所需的基础库，导致pip编译安装失败。

解决方法：在项目根目录创建post_deploy.sh脚本，添加以下内容：

apt-get update && apt-get install -y libssl-dev libffi-dev gcc

Azure会在部署过程中自动执行这个脚本，安装编译依赖后再进行pip安装。

3. 升级pip和setuptools到兼容版本 #

旧版本的pip/setuptools可能无法正确处理该包的依赖解析或编译流程，建议先升级工具链：

在requirements.txt的最顶部添加：

pip>=21.0.0
setuptools>=57.0.0

这样部署时会先升级pip和setuptools，再安装其他依赖。

4. 使用预编译的Wheel包跳过编译 #

如果上述方法还是无法解决编译问题，可以直接使用预编译的wheel包避免现场编译：

• 本地下载对应Python版本和平台的wheel包（比如manylinux版本），放到项目根目录
• 修改requirements.txt，将azure-iothub-device-client==1.3.2替换为本地wheel文件路径，例如：

./azure_iothub_device_client-1.3.2-cp37-cp37m-manylinux1_x86_64.whl

你的部署日志片段：

PS C:\Users\hackuser1\Desktop\Madhu\tryPythonWeb\python-docs-hello-world> git push azure master
Counting objects: 3, done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 324 bytes | 108.00 KiB/s, done.
Total 3 (delta 1), reused...

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