conda build中脚本导入lxml.etree失败但命令执行成功的原因排查

核心问题 #

用conda build构建steel包时，执行入口点脚本mgx-analyse --help会触发ImportError: DLL load failed while importing etree: 找不到指定模块，但以下场景完全正常：

• 直接执行python -c "from lxml import etree"
• 手动激活测试环境后运行mgx-analyse --help或上述Python命令

已确认meta.yaml的requirements.run声明了lxml=4.8.0，测试环境中lxml及依赖的libxml2.dll所属包均已安装，调试显示两种场景下sys.executable、CONDA_PREFIX、CONDA_SHLVL完全一致，脚本也未修改过DLL搜索路径。

排查与解决步骤 #

1. 检查PATH变量差异 #

Conda Build在测试阶段会调整PATH变量，可能导致libxml2.dll所在目录未被纳入搜索路径。

• 排查操作：在入口点脚本开头加调试代码，打印当前PATH：

  import os
  print("当前PATH:", os.environ.get("PATH", ""))
  

  对比直接执行python -c "import os; print(os.environ.get('PATH'))"的输出，重点看conda环境Library\bin目录（libxml2.dll所在位置）是否在PATH中，且顺序是否靠前。
• 修复方案：在meta.yaml的test阶段显式调整PATH，或者在脚本中临时添加DLL目录：

  # meta.yaml 中 test 区块
  test:
    commands:
      - set PATH=%CONDA_PREFIX%\Library\bin;%PATH% && mgx-analyse --help
  

  或者在入口点脚本开头加入：

  import os
  conda_prefix = os.environ.get("CONDA_PREFIX")
  if conda_prefix:
      dll_dir = os.path.join(conda_prefix, "Library", "bin")
      os.add_dll_directory(dll_dir)
  

2. 校验入口点脚本的执行上下文 #

Conda自动生成的入口点脚本可能存在解释器路径错误，或执行时未正确继承conda环境上下文。

• 排查操作：找到测试环境Scripts目录下的mgx-analyse脚本/可执行文件，确认其指向的Python路径是否与sys.executable一致。
• 修复方案：在meta.yaml中确保入口点配置正确，或测试时直接通过Python调用模块：

  # meta.yaml 中 entry_points 区块
  entry_points:
    console_scripts:
      - mgx-analyse = steel.cli:main
  

  同时修改测试命令：

  test:
    commands:
      - python -m steel.cli --help
  

3. 显式声明隐性依赖 #

虽然lxml依赖libxml2，但Conda Build的隔离机制可能导致隐性依赖未被正确加载，显式声明可解决此问题。

• 修复方案：在meta.yaml的requirements.run中添加libxml2：

  requirements:
    run:
      - lxml=4.8.0
      - libxml2
  

4. 清理缓存重新构建 #

Conda Build的缓存可能残留旧环境文件，导致测试环境未正确更新。

• 操作命令：

  conda build purge
  conda build --no-build-id --no-test --force steel/
  conda build --test steel/
  

附：参考信息 #

• 脚本调试代码
• conda build报错日志
• meta.yaml配置
• 构建环境的conda info信息

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