首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >用 WorkBuddy 写的程序,打包成 EXE 却一启动就秒退:12 个坑全是打包后才现形

用 WorkBuddy 写的程序,打包成 EXE 却一启动就秒退:12 个坑全是打包后才现形

原创
作者头像
用户12864818
发布于 2026-11-17 22:10:42
发布于 2026-11-17 22:10:42
770
举报

我做了一个跑在本地 Windows 上的 AI 中控:桌宠唤醒、离线语音、本地记忆、浏览器自动化,晚上还会自己跑一轮迭代。这篇不讲架构,只讲坑。

先说个让我挺没面子的事实:python app.py 跑了几个月,一切正常;打成 EXE 之后,一启动就秒退。

下面这 12 个坑有个共同点——开发态一个都测不出来,只在打包之后、某个特定条件下才炸。每一个都花了我几小时到几天。最贵的那个(0xC0000409)我查了三天。数字和报错都来自我自己的构建日志,没修饰过。


坑 1:一个 emoji 能直接杀死你的进程

打包后的 EXE 一启动就秒退,开发态跑得好好的。我当时第一反应是依赖没打进去,翻了半天 spec 文件,全对。

真正的原因是编码。PyInstaller --windowed 模式下 EXE 没有控制台,Python 拿不到 GetConsoleCP(),只能退回系统 ANSI 代码页——中文机器就是 CP936/GBK。于是这一行:

代码语言:python
复制
print("[灵境] 安全体检通过 ✅")
# UnicodeEncodeError: 'gbk' codec can't encode character '\u2705'

进程当场就没了。网关一退,桌宠拉不起来,健康检查一直连不上,下游全断。一个对勾符号,干掉一整条链路。

解法是入口统一重配标准输出,日志里也别放 emoji:

代码语言:python
复制
import sys

def configure_stdio():
    for stream in (sys.stdout, sys.stderr):
        try:
            stream.reconfigure(encoding="utf-8", errors="replace")
        except Exception:
            pass

以后凡是「打包后秒退但开发态正常」,我第一反应就查 stdout 编码。 这条写成规矩了。

坑 2:EXE 不能启动「自己」

onefile 打包出来的 EXE,如果代码里用 subprocess 再启动自己,父子进程会抢同一个 _MEIxxxx 临时解压目录和 DLL 锁,直接 0xC0000409 (STATUS_STACK_BUFFER_OVERRUN)。

这个我查了三天。因为它只在打包态出现,源码态怎么跑都没事,日志里连个像样的异常都没有。

解法不优雅但有效:子进程必须打成另一个独立的 exe。我最后拆成三个 EXE——桌宠 / 网关 / 中枢,各干各的。还有个附带发现:onefile EXE 的子进程不能用 CREATE_NO_WINDOW,实测同样触发 0xC0000409。这两条我现在写进打包清单,谁改谁先看。

坑 3:Windows 子进程管道会死锁

用 PIPE 接管子进程输出,缓冲区(约 64KB)填满后子进程阻塞等读取,父进程却在等子进程结束——两头互相等,谁也不动。

现象特别阴:不报错、不超时、任务就那么挂着。后台子进程一律 DEVNULL:

代码语言:python
复制
subprocess.Popen(
    [sys.executable, "gateway.py"],
    stdout=subprocess.DEVNULL,
    stderr=subprocess.DEVNULL,
)

说白了,Windows 上「父进程读子进程输出」这件事,别默认以为管道是无底的。

坑 4:.env 在打包态找不到

PyInstaller 的 __file__ 指向临时解压目录 _MEIPASS,那里没有用户的 .env。服务拿不到令牌,直接拒绝启动。

打包脚本必须把 .env 拷进 dist,而且查找逻辑只认 exe 同目录。别写「向上找三级」那种聪明代码,打包态的目录树跟你想象的不一样。

坑 5:清理目录不能用 rmtree

在带安全护栏的环境里,批量删除会被拦,构建直接失败。更坑的是 PyInstaller 覆盖旧 .exe 时内部会调 os.remove,被护栏接管后构建中断——报错信息指向构建工具,你根本不会怀疑是自己那行清理脚本。

解法挺土的:把旧目录改名移走。move 不是 delete,护栏不拦,照样拿到一个干净的 dist。我承认第一次想到这个办法时觉得自己有点傻,但它稳定跑了几个月。

坑 6:清理素材必须双目录同清

只清源码 assets、不清 dist/assets,打包版照样读旧文件。

我踩过一次:47 张旧动画帧被一起复制进了 dist。源码目录的断言全过,打包版一跑全是旧的。当时我对着「全绿」的测试输出看了很久,才反应过来测的是另一份文件。

源码绿,不等于产物绿。 现在凡是清理动作,我都先问一句:这份文件有几个副本?

坑 7:断言全绿 ≠ 界面好看

有一次所有断言都通过,我顺手截了张图——气泡被 wordWrap 挤成竖排,一个字一行。

断言测不出「丑」,也测不出「挤」。后来我加了条硬规矩:UI 改动后必须出离屏快照人工过目。这条不是技术问题是流程问题,机器帮不了你,得有人真的看一眼。

坑 8:QScrollArea 滚动失效三连坑

Qt 的滚动区是连环的:① 末尾 stretch 把内容压扁;② setWidgetResizable(True) 强制 widget 等于视口高、忽略 sizeHint;③ 每次 resize 会重置 widget 尺寸。

解法是 setWidgetResizable(False) + 自己同步宽度 + 监听 resize 重同步:

代码语言:python
复制
area.setWidgetResizable(False)
area.setWidget(inner)

def _sync_width():
    inner.setFixedWidth(max(area.viewport().width(), 300))

那个 max(..., 300) 下限也是被坑出来的——布局没完成时 viewport().width() 会返回一个很小的正值,内容直接被压成「竹竿」。这种数字你不亲自撞一次,根本不会想到要写。

坑 9:改超时必须同步改看门狗

我把模型超时从 12 秒提到 60 秒,忘了 UI 那边的看门狗还是 15 秒——成功的回答被当成超时丢掉了。

两边单看都对,合起来就错。这类坑最烦人,因为没有任何一处代码是「错」的。后来我按最坏链路重算整套时间常数,并给推理模型单独超时:同一个模型、同一个问题,耗时能从 2.8 秒波动到 60 秒以上,复用通用超时必然误杀。

坑 10:代理会劫持你的本地请求

机器上有代理时,两件事同时发生:本地 127.0.0.1 的请求被代理劫持,连不通;同时 httpx 默认读 HTTPS_PROXY,把本该出网的 LLM 请求也一并带进代理。

解法分两头:本地请求单独走一套绕过代理的函数;浏览器显式指定 --proxy-server,并且一定加上 --proxy-bypass-list=127.0.0.1,localhost。第二行是救命的,不加它,浏览器连本地调试端口都会绕道走,现象是「浏览器起来了但就是连不上」。

坑 11:模型名不是模型名

"Hy4 preview" 是客户端的平台档位,"hy4-preview" 是云 API 的模型 id。我以为是一个东西,直连调不通,排查很久。

写模型名之前先真机调一次。 平台档位和底层模型 id 是两层,名字像不代表是一个对象。这条我给 AI 搭档也立了规矩:不确定的 API、参数、价格一律标「待核实」,不许凭记忆硬编——凭记忆写 API 签名,是把自己当编译器用,编译还不过。

坑 12:mock 全绿是最危险的假信号

有两处真 Bug(多行代码被截断、盘符被吞)在 mock 环境全绿,真机一跑就报错。

铁律:改完必须用真实 API 跑一遍真机自证,不能只跑 mock。 mock 验证的是「我以为它会怎么跑」,不是「它实际怎么跑」。


收尾:三条我攒下来的规矩

先立门禁,再堆功能。 我的测试从 29 条断言长到 556 条。没有门禁的功能堆砌是在埋定时炸弹。还有一条同样值钱:先修崩溃再修失败——崩溃会让后面的断言全部不执行,制造「看起来还行」的假象,我的一次崩溃就掩盖了 10 个真实失败。

把事故写成规矩。 每次踩坑都沉淀成一条能执行的规则(「改超时必须同步重算看门狗」「UI 改动必须出快照」)。这些规则的价值远超当时修掉的那个 Bug。我攒了 34 条,每次开工前让 AI 读一遍,等于它把我的教训全继承了一遍。

不确定就标出来。 这条前面说过,值得再说一次:它防的不是 bug,是那种「看起来完成了」的错觉。

可带走物:打包前自查清单

这 12 个坑我整理成一张表,下次打 EXE 之前对着过一遍,能省掉大半的返工:

打包前检查项

没做会怎样

1

入口重配 stdout/stderr 为 utf-8,日志里零 emoji

中文机器 CP936/GBK,一个对勾直接秒退

2

子进程打成独立 exe,不用 CREATE_NO_WINDOW

抢 _MEIxxxx 目录锁,0xC0000409

3

后台子进程 stdout/stderr 一律 DEVNULL

64KB 缓冲区填满,父子互等死锁

4

.env 拷进 dist,查找只认 exe 同目录

__file__ 指向 _MEIPASS,拿不到令牌拒绝启动

5

旧目录用 move 移走,不用 rmtree / os.remove

被安全护栏拦下,构建中断且报错误导

6

assets 与 dist/assets 双目录同清

源码断言全绿,47 张旧帧跑进产物

7

UI 改动后出离屏快照人工过目

断言全绿,气泡被挤成一个字一行

8

setWidgetResizable(False) + 宽度下限 300

布局未完成时内容被压成「竹竿」

9

改任一超时,同步重算看门狗与推理模型独立超时

15 秒看门狗丢掉 60 秒才回来的正确回答

10

本地请求绕过代理,浏览器加 --proxy-bypass-list

127.0.0.1 被劫持,浏览器起来了连不上

11

平台档位与云 API 模型 id 分开写真机调一次

两个名字看着像,直连调不通

12

改完跑真机自证,不拿 mock 全绿当结论

多行代码被截断、盘符被吞,真机才炸

说实话,这 12 条没有一条是靠「更仔细地读代码」发现的,全是被打包态的运行结果撞出来的。所以我现在的顺序是:先让它以 EXE 的形态跑一遍,再回头看断言。


本文的 12 个坑此前收在我另一篇总览长文里,这次单独拆开、补了打包前后的现象对照和这张自查清单,标题与结构也做了调整。文中数字(断言数、帧数、超时秒数、错误码)均来自项目真实构建日志,随迭代变化,请以自己机器上实际跑出来的为准。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 坑 1:一个 emoji 能直接杀死你的进程
  • 坑 2:EXE 不能启动「自己」
  • 坑 3:Windows 子进程管道会死锁
  • 坑 4:.env 在打包态找不到
  • 坑 5:清理目录不能用 rmtree
  • 坑 6:清理素材必须双目录同清
  • 坑 7:断言全绿 ≠ 界面好看
  • 坑 8:QScrollArea 滚动失效三连坑
  • 坑 9:改超时必须同步改看门狗
  • 坑 10:代理会劫持你的本地请求
  • 坑 11:模型名不是模型名
  • 坑 12:mock 全绿是最危险的假信号
  • 收尾:三条我攒下来的规矩
  • 可带走物:打包前自查清单
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档