Python3.12部署Azure App Service时pathlib导入Sequence报错求助

问题根源 #

你遇到的问题是部署环境中安装了第三方旧版本的pathlib包，而非Python 3.4+自带的标准库pathlib。旧版第三方pathlib仍在使用from collections import Sequence的写法，这在Python 3.10+中已完全失效。本地运行正常是因为你没装第三方pathlib，直接用的标准库版本。

分步解决 #

1. 彻底清理依赖中的第三方pathlib #

• 打开requirements.txt，确保没有pathlib这条依赖（如果之前有，删除后保存）。
• 检查其他依赖包是否间接依赖旧版pathlib：
  运行本地命令排查：

  pip show <你的依赖包名>
  

  查看每个包的Requires字段，找到依赖旧pathlib的包，要么升级该包到兼容Python 3.10+的版本，要么替换为替代包。

2. 清理部署环境缓存 #

GitHub Actions部署时可能残留旧依赖缓存，需添加清理步骤：
在你的GitHub Workflow的部署脚本中，安装依赖前加入：

pip cache purge
rm -rf venv  # 如果用了虚拟环境

同时，登录Azure门户，进入你的Web App，执行重启操作，清理服务器端的旧缓存。

3. 确认Azure运行时Python版本 #

检查Azure App Service的运行时配置：

• 进入Azure门户 → 你的Web App → 设置 → 配置 → 常规设置
• 确认“Python版本”选择的是3.12，避免环境版本不匹配导致的标准库异常。

4. 代码层面强制使用标准库pathlib（临时应急） #

如果以上步骤仍未解决，可在Flask应用入口文件开头添加以下代码，强制加载标准库的pathlib：

import sys
# 检查是否加载了第三方pathlib
if 'pathlib' in sys.modules:
    pathlib_module = sys.modules['pathlib']
    # 判断是否为第三方包（标准库路径包含sys.prefix）
    if not pathlib_module.__file__.startswith(sys.prefix):
        del sys.modules['pathlib']
# 重新导入标准库pathlib
import pathlib

验证方法 #

部署完成后，在Azure Web App的Kudu控制台中运行：

python -c "import pathlib; print(pathlib.__file__)"

如果输出路径包含lib/python3.12/pathlib.py，说明用的是标准库版本，问题解决。

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