使用os.system()启动Streamlit打包exe后无法运行的问题排查

DevOps 小满

2026-6-20

解决Streamlit打包exe后无法启动的问题

以下是几个可行的修复方案，按优先级尝试：

1. 改用subprocess捕获错误输出，排查根本问题

os.system无法显示执行时的错误信息，闪退还不知道哪里出问题。换成subprocess.run并保留控制台输出，能帮你定位错误：

import os
import subprocess
import sys

# 获取当前exe所在目录（打包后也能正确获取）
exe_dir = sys._MEIPASS if hasattr(sys, '_MEIPASS') else os.path.dirname(os.path.abspath(sys.argv[0]))
main_path = os.path.join(exe_dir, 'main.py')

# 执行命令并保留输出
try:
    result = subprocess.run(
        ['streamlit', 'run', main_path],
        shell=True,
        check=True,
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        text=True
    )
    print(result.stdout)
except subprocess.CalledProcessError as e:
    print(f"执行出错: {e.stderr}")
    input("按回车键关闭窗口...")  # 防止窗口闪退，能看到错误详情

打包时不要加-w参数，保留控制台窗口，这样就能看到具体报错。

2. 打包时强制收集Streamlit的所有依赖

PyInstaller可能没自动收集Streamlit的静态资源、配置文件等，导致启动失败。打包时添加--collect-all streamlit参数：

pyinstaller --onefile --collect-all streamlit your_startup_script.py

如果需要生成单文件exe，保留--onefile；如果是多文件部署，可去掉该参数。

3. 确保工作目录正确

打包后exe的默认工作目录可能不是你存放main.py的目录，所以在启动脚本里明确指定工作目录：

import os
import subprocess
import sys

exe_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
# 切换到main.py所在目录
os.chdir(exe_dir)

subprocess.run(['streamlit', 'run', 'main.py'], shell=True)

把main.py和生成的exe放在同一目录下，这样相对路径就能正确识别。