使用PyInstaller打包单文件Eel Python应用后运行报错如何解决？

核心原因 #

使用--onefile参数打包时，PyInstaller会将所有资源打包进单个可执行文件，程序运行时会临时解压到系统临时目录。但你原命令里直接指定了本地绝对路径的web文件夹，程序运行时无法在临时环境中找到这个固定路径的资源，从而触发报错。

具体解决步骤 #

1. 修改Eel初始化代码
   在eelTest.py中添加路径处理逻辑，适配PyInstaller的临时运行环境，改用相对路径加载web资源：

   import eel
   import sys
   import os
   
   def resource_path(relative_path):
       # 获取打包后资源的实际路径
       try:
           base_path = sys._MEIPASS
       except Exception:
           base_path = os.path.abspath(".")
       return os.path.join(base_path, relative_path)
   
   # 用处理后的路径初始化Eel
   eel.init(resource_path('web'))
   eel.start('main.html')
   

2. 调整打包命令
   移除原命令中web文件夹的绝对路径，改用--add-data参数将web目录打包进可执行文件，命令修改为：

   python.exe -m eel --onefile --add-data "c:\Users\Darek\PycharmProjects\eelTest\web;web" c:\Users\Darek\PycharmProjects\eelTest\eelTest.py
   

   注意：Windows系统下用;分隔源路径和目标路径，Linux/macOS系统则用:。

3. 验证基础配置
   确认main.html确实位于web文件夹根目录，且eel.start()中指定的文件名和实际文件名完全一致（Windows下大小写不敏感，但跨平台场景需注意）。

额外排查方向 #

• 检查系统临时目录权限：程序运行时需要写入系统临时目录（通常为C:\Users\Darek\AppData\Local\Temp\_MEIxxxxxx），确保该目录未被杀毒软件拦截或限制写入。
• 可在代码中添加打印语句，输出resource_path('web')的结果，确认资源路径是否正确。

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