Azure部署Django应用图片上传失败：无法导入_imaging

我之前帮不少开发者解决过这个问题——本地运行正常，但Azure部署的Django Admin上传图片时触发cannot import name _imaging错误，核心原因基本都是Pillow在Azure的云端环境中未正确编译或依赖缺失，毕竟本地开发环境和Azure的服务器环境存在差异。下面是几个针对性的解决步骤：

1. 锁定兼容的Pillow版本并强制使用二进制轮子 #

本地环境的Pillow可能是编译好的，但Azure部署时如果用源码编译，很容易因为缺少系统依赖失败。你可以在requirements.txt里指定一个经过验证的稳定版本，并强制使用预编译的二进制包：

Pillow==9.5.0 --only-binary :all:

这样部署时会直接下载对应Python版本和平台的预编译轮子，避免云端编译出错。

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

如果你的本地Python版本和Azure Web App配置的版本不一致，Pillow的编译产物也会不兼容。请：

• 检查本地Python版本（终端运行python --version）
• 登录Azure门户，进入你的Web App → 配置 → 常规设置，将Python版本调整为和本地一致的版本

3. 给Linux环境的Azure Web App补充系统依赖 #

如果你的Azure Web App用的是Linux容器，Pillow需要依赖libjpeg和zlib等系统库来处理图片。你可以通过自定义启动脚本安装这些依赖：

1. 在项目根目录创建一个startup.sh文件，内容如下：

#!/bin/bash
apt-get update && apt-get install -y libjpeg-dev zlib1g-dev
# 然后启动你的Django应用，比如：
gunicorn your_project_name.wsgi:application --bind 0.0.0.0:$PORT

2. 在Azure门户的Web App → 配置 → 常规设置，将“启动命令”设置为./startup.sh

4. 清除Azure部署缓存并重新部署 #

有时候旧的虚拟环境缓存会导致依赖冲突，你可以通过Kudu工具清理：

• 登录Azure门户，进入Web App → 高级工具 → 进入Kudu
• 打开Debug Console → CMD，删除site\wwwroot\env文件夹（虚拟环境目录）
• 重新触发部署（比如从GitHub/Azure Repos重新同步）

5. 查看详细日志定位深层问题 #

如果上面的步骤都没解决，建议查看Azure的应用日志流：

• 进入Web App → 监测 → 日志流
• 查看Pillow安装过程中的报错信息，比如是否有“缺少xxx库”的提示，再针对性补充依赖

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