PyInstaller单文件exe添加falcon.responders隐藏导入仍报错

问题场景 #

使用PyInstaller将s2rdf.py打包为单文件exe时，出现falcon.responders导入错误。已将'falcon.responders'添加到spec文件的hiddenimports列表中，但运行生成的exe仍触发导入错误。

报错栈 #

Traceback (most recent call last):
  File "s2rdf.py", line 62, in <module>
    import morph_kgc
  File "PyInstaller\loader\pyimod03_importers.py", line 495, in exec_module
  File "morph_kgc\__init__.py", line 16, in <module>
  File "PyInstaller\loader\pyimod03_importers.py", line 495, in exec_module
  File "morph_kgc\engine.py", line 16, in <module>
  File "PyInstaller\loader\pyimod03_importers.py", line 495, in exec_module
  File "morph_kgc\materializer.py", line 14, in <module>
  File "PyInstaller\loader\pyimod03_importers.py", line 495, in exec_module
  File "falcon\__init__.py", line 32, in <module>
  File "falcon\app.py", line 24, in init falcon.app
ImportError: cannot import name responders
[16196] Failed to execute script 's2rdf' due to unhandled exception!

spec文件片段 #

a = Analysis(
    ['s2rdf.py'],
    pathex=[],
    binaries=[],
    datas=[],
    hiddenimports=['falcon.app_helpers','falcon.responders'],
    hookspath=[],
    hooksconfig={},

问题原因及解决方向 #

• Falcon版本兼容性：不同版本的Falcon中responders模块的结构可能有变化，部分版本里该模块可能被重命名或移动位置，需核对当前Falcon版本的模块结构，确认正确导入路径。
• PyInstaller钩子缺失：手动添加hiddenimports后仍未生效，可能是PyInstaller未识别Falcon内部的动态导入逻辑。可创建自定义钩子文件（如hook-falcon.py），在其中显式声明所有依赖模块，包括falcon.responders及关联子模块。
• 单文件打包路径问题：单文件模式下，PyInstaller将资源打包到临时目录，部分模块的相对导入可能出现路径解析错误。可先尝试打包为非单文件模式测试，若正常运行，再针对单文件模式调整datas或pathex配置。
• Morph-KGC隐式依赖遗漏：Morph-KGC导入时可能动态引用了Falcon的其他子模块，这些模块未被添加到hiddenimports中。需分析Morph-KGC源码，找出所有间接依赖的Falcon模块，一并添加到hiddenimports列表。

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