Azure Web Job Python下导入pandas/numpy报missing_dependencies错误

问题本质 #

你看到的pandas初始化时触发的missing_dependencies.append(f"{dependency}: {e}")报错，本质是pandas在初始化阶段捕获到numpy加载失败的底层异常，自动将numpy标记为缺失依赖。
pandas、numpy属于带原生C编译扩展的第三方包，对Python解释器的小版本号、系统架构、宿主OS环境有严格的编译匹配要求，纯Python实现的包（比如requests、标准库）无此类限制，这也是你遇到标准库、requests可以正常导入，但numpy、pandas触发依赖缺失报错的核心原因——和Python 2/3版本无关，根源是环境不匹配。

排查与解决步骤 #

1. 先确认Web Job实际运行的Python解释器参数 #

不要跳过这步直接重新装包，先在Web Job的入口脚本最开头插入以下诊断代码，把实际运行参数打印到Web Job的日志中：

import sys
import platform
print("解释器路径：", sys.executable)
print("Python版本：", sys.version)
print("系统架构：", platform.architecture())

日志输出后重点核对三个匹配维度：

• Python解释器的小版本号（如3.9/3.10/3.11，任意小版本差异都会导致原生扩展加载失败）
• 解释器对应的系统架构（32位/64位）
• 解释器运行的宿主系统（Windows/Linux）
  注：你提到同Web应用下的普通代码导入pandas正常，本质是普通Web进程用的是Azure平台预置的Python环境，和Web Job进程实际调用的解释器不是同一个路径，自然会出现环境不一致的问题。

2. 按匹配的环境正确部署依赖 #

不要通过本地创建venv、打包site-packages的方式上传依赖，这类操作90%会出现编译环境不匹配的问题，按以下方式操作：

• Windows宿主的Web应用场景：
  • 先在Web应用的扩展配置中，安装平台官方提供的Python 3.x扩展，记录下该Python的版本、架构参数
  • 通过Web应用自带的Kudu控制台，直接激活平台预置的Python环境，执行pip install pandas numpy将包安装到平台的系统site-packages路径下
  • 在Web Job的启动脚本中，显式将上述site-packages路径的优先级加到sys.path最前端，避免Web Job临时目录下的不兼容包被优先加载
• Linux宿主的Web应用场景：
  不要使用Windows环境下编译的pandas/numpy包，Windows编译的二进制扩展完全无法在Linux进程中加载，需要在Linux环境下重新安装对应版本的依赖后再打包部署。

3. 针对性排除特殊兼容问题 #

• 不要尝试切换到Python 2.x环境：当前主流版本的pandas、numpy已完全停止对Python 2的维护，切换后只会遇到更难解决的版本兼容问题，无实际收益
• 核对Web应用的平台位数配置：在Web应用的常规配置中，将“平台位数”设置为和安装的Python包架构完全一致（如安装64位Python包时，需关闭32位应用模式，32位进程加载64位二进制DLL会直接触发加载失败）
• 不要跨进程引用其他项目的site-packages路径：你之前将Web应用自身env的site-packages追加到sys.path的操作，如果该env的解释器版本、架构和Web Job实际调用的解释器不匹配，反而会加剧加载失败的问题

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