PyInstaller打包SQLAlchemy+SQLite应用后无法打开数据库文件

问题场景 #

基于PyQt5开发的应用，使用SQLAlchemy管理SQLite数据库，本地Python运行完全正常，但通过PyInstaller打包为.exe后，运行时抛出以下错误：

sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) unable to open database file

错误原因分析 #

1. 路径拼接错误：os.path.join(ROOT, "/model/database.db")中第二个参数带前导斜杠，导致os.path.join直接忽略前面的ROOT路径，生成错误的绝对路径，与打包后数据库文件的实际位置不匹配。
2. 打包后路径识别错误：开发环境中os.path.dirname(__file__)指向脚本所在目录，但PyInstaller打包后，__file__指向临时解压的脚本路径，而非最终exe所在目录，导致无法定位到正确的数据库文件。
3. 文件存在性判断路径错误：硬编码路径拼接ROOT + "/model/database.db"未使用跨平台的路径处理方式，且与实际打包后的路径结构不符。

修复步骤 #

1. 修正根路径获取逻辑 #

区分开发环境与打包后的环境，获取正确的根目录：

import os
import sys

def get_root_path():
    if getattr(sys, 'frozen', False):
        # 打包后，返回exe所在目录
        return os.path.dirname(sys.executable)
    else:
        # 开发环境，返回当前脚本所在目录
        return os.path.dirname(__file__)

ROOT = get_root_path()

2. 修正数据库路径拼接 #

使用os.path.join正确拼接路径，避免前导斜杠导致的路径异常：

SQLITE_DATABASE_URI = os.path.join(ROOT, "model", "database.db")

3. 修正数据库连接与存在性判断 #

# 初始化SQLAlchemy引擎
self.engine = create_engine(f"sqlite:///{SQLITE_DATABASE_URI}", echo=False)

# 检查数据库文件是否存在，不存在则创建表
if not os.path.isfile(SQLITE_DATABASE_URI):
    Base.metadata.create_all(self.engine)

4. 确认.spec文件的资源配置 #

保持现有.spec文件中的datas配置不变，确保数据库文件被正确打包到输出目录的model文件夹下：

datas=[
    ("resources", "resources"), 
    ("resources.qrc", "."), 
    (r"model\database.db", "model"),
    (r".venv\Lib\site-packages\qtstylish\compiled", "qtstylish\compiled")
],

验证方法 #

重新执行PyInstaller打包命令：

pyinstaller your_app.spec

运行生成的.exe文件，确认数据库连接正常，无报错。

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