如何将嵌入PyQt5的Flask应用打包为单文件EXE

问题背景 #

已有三个核心文件：

• app.py：包含Flask路由与业务逻辑
• db_manager.py：负责数据库查询处理
• pyqt.py：通过PyQt5封装为桌面应用，本地运行正常，需打包为单文件可执行EXE

打包步骤（基于PyInstaller） #

1. 安装PyInstaller #

pip install pyinstaller

2. 调整Flask运行参数 #

修改pyqt.py中的start_flask_app方法，关闭Flask自动重载（打包后会引发多线程冲突）：

def start_flask_app(self):
    # 新增use_reloader=False关闭自动重载，强制debug=False避免打包异常
    flask_thread = Thread(target=flask_app.run, kwargs={'host': 'localhost', 'port': 5000, 'debug': False, 'use_reloader': False})
    flask_thread.daemon = True
    flask_thread.start()

3. 生成并修改Spec配置文件 #

先生成默认Spec文件：

pyi-makespec --onefile pyqt.py

打开生成的pyqt.spec，完成以下关键修改：

（1）补充隐藏导入

PyInstaller无法自动识别部分依赖模块，在hiddenimports中添加缺失项：

hiddenimports=['flask', 'flask.app', 'db_manager', 'PyQt5.QtWebEngineWidgets', 'PyQt5.QtCore', 'PyQt5.QtWidgets']

（2）添加资源文件

如果Flask用到templates/static文件夹，或db_manager依赖本地数据库文件（如SQLite的.db），通过datas参数打包资源：

# 示例：将templates、static文件夹，以及data.db数据库文件打包
datas=[
    ('templates', 'templates'),
    ('static', 'static'),
    ('data.db', '.')
]

（3）调整打包核心配置

确保生成窗口程序（而非控制台），最终Analysis段示例：

a = Analysis(
    ['pyqt.py'],
    pathex=[],
    binaries=[],
    datas=[('templates', 'templates'), ('static', 'static'), ('data.db', '.')],
    hiddenimports=['flask', 'flask.app', 'db_manager', 'PyQt5.QtWebEngineWidgets', 'PyQt5.QtCore', 'PyQt5.QtWidgets'],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)

4. 修正数据库路径逻辑 #

打包后程序会临时解压到系统临时目录，需在db_manager.py中添加动态路径获取逻辑：

import sys
import os

def get_db_path():
    # 判断是否为打包后的运行环境
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, 'data.db')
    # 开发环境直接使用本地路径
    return 'data.db'

后续数据库连接时调用该方法：

conn = sqlite3.connect(get_db_path())

5. 执行打包命令 #

pyinstaller --clean pyqt.spec

打包完成后，单文件EXE将生成在dist目录下。

常见问题排查 #

• 模块缺失报错：检查hiddenimports是否补充了对应模块
• 数据库连接失败：确认datas已包含数据库文件，且路径获取逻辑正确
• PyQt5 WebEngine加载失败：确保PyInstaller与PyQt5版本兼容，部分版本需手动添加WebEngine依赖文件

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