PyInstaller编译Flask多脚本应用报未导入模块错误如何解决

• 先验证本地原生运行状态：执行 python app.py 确认项目本身无语法错误、无导入错误，所有功能正常运行。你后续反馈语法错误是问题根源，优先排查代码拼写、导入语句、语法规范问题。
• 修正app.spec配置文件：
  1. Analysis参数的首个列表需要加入所有自定义项目脚本，避免PyInstaller漏检依赖
  2. pathex替换为项目根目录的绝对路径，不要使用占位值path/to/file
  3. hiddenimports新增第三方库隐式依赖的utils模块，以及所有自定义模块
     修正后的参考配置如下：

  # -*- mode: python ; coding: utf-8 -*-
  block_cipher = None
  a = Analysis(
      ['app.py', 'core.py', 'cctrl.py', 'helpers.py'],
      pathex=['替换为你的项目根目录实际绝对路径'],
      binaries=[],
      datas=[('templates', 'templates'), ('static', 'static')],
      hiddenimports=['jinja2.ext', 'openpyxl', 'docx', 'utils', 'helpers', 'core', 'cctrl'],
      hookspath=[],
      hooksconfig={},
      runtime_hooks=[],
      excludes=[],
      win_no_prefer_redirects=False,
      win_private_assemblies=False,
      cipher=block_cipher,
      noarchive=False
  )
  pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
  exe = EXE(
      pyz,
      a.scripts,
      a.binaries,
      a.zipfiles,
      a.datas,  
      [],
      name='reporter',
      debug=False,
      bootloader_ignore_signals=False,
      strip=False,
      upx=True,
      upx_exclude=[],
      runtime_tmpdir=None,
      console=True,
      disable_windowed_traceback=False,
      target_arch=None,
      codesign_identity=None,
      entitlements_file=None 
  )
  

• 清理历史缓存：每次打包前删除项目下的build、dist文件夹，避免旧的编译缓存导致异常报错。
• 执行打包命令：直接使用修改后的spec文件执行打包即可：

  pyinstaller app.spec
  

错误原因说明 #

• 找不到utils模块：是你使用的docx、openpyxl等第三方依赖内部有隐式导入utils的逻辑，PyInstaller自动扫描时没有识别到，需要手动加入隐藏导入列表。
• 找不到helpers等自定义模块：是因为你只在Analysis里指定了入口文件app.py，PyInstaller没有自动识别到同目录下的其他自定义脚本，手动加入源文件列表或隐藏导入列表即可解决。

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