Python3.12环境下Django导入XLSX报错：No module named expat

问题背景 #

在Python 3.12.9的Conda环境中，执行Django命令：

python manage.py populate_service_catalog auxillary\services\example.xlsx

出现错误：ImportError: No module named expat; use SimpleXMLTreeBuilder instead，但同一环境下Jupyter Notebook中执行df = pd.read_excel(r'auxillary\services\example.xlsx')正常，仅降级到Python 3.6.13时两种场景均正常。

可能原因 #

1. Conda环境中的Python编译时未包含expat内置库支持，expat是Python处理XML的核心依赖，Django命令中使用的Excel解析逻辑（或关联库）依赖该模块，而pandas在Jupyter中使用的解析引擎未触发此依赖。
2. Django自定义命令populate_service_catalog中使用的XML解析库与pandas依赖的Excel解析引擎不同，导致环境差异暴露。

解决方案 #

1. 验证并修复Conda环境的expat支持 #

• 激活环境后，执行以下命令检查expat是否可用：

  python -c "import xml.parsers.expat"
  

  若报错，说明Python编译缺失expat支持，执行以下步骤修复：
  1. 安装独立的expat包：

     conda install -c conda-forge expat
     

  2. 重新安装Python 3.12.9（确保从conda-forge频道获取完整编译版本）：

     conda remove python --force
     conda install python=3.12.9 -c conda-forge
     

2. 统一Excel解析引擎 #

• 检查Django自定义命令中读取XLSX的代码，确保使用与pandas相同的解析引擎（如openpyxl）：
  1. 安装openpyxl：

     conda install openpyxl
     

  2. 在命令代码中指定引擎：

     import pandas as pd
     df = pd.read_excel('auxillary\services\example.xlsx', engine='openpyxl')
     

  此举可避免触发依赖expat的XML解析路径。

3. 临时兼容处理（不推荐，仅应急使用） #

若无法重新安装Python，可在Django命令代码开头添加兼容逻辑，替换expat依赖：

try:
    import xml.parsers.expat
except ImportError:
    from xml.etree import ElementTree
    # 替换为不依赖expat的XML解析实现
    import xml.etree.cElementTree as ElementTree

注意：此方法可能存在兼容性问题，仅作为临时方案。

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