pywebview桌面程序关闭后同一终端再次启动无响应问题复盘

问题现象

在 Windows PowerShell 中运行：

bash 复制代码

python -m src.main

第一次可以正常启动 VideoScribe 桌面窗口。关闭窗口后，在同一个终端中再次执行：

bash 复制代码

python -m src.main

终端会立刻返回提示符，桌面窗口没有出现，也没有明显错误日志。

典型日志表现如下：

text 复制代码

PS E:\qclaw_workspace\video-scribe> python -m src.main
2026-06-16 08:11:55,625 [INFO] src.desktop: 正在启动桌面窗口: E:\qclaw_workspace\video-scribe\ui\index.html
2026-06-16 08:16:24,354 [INFO] src.desktop: 检测到桌面窗口关闭，准备取消任务并释放资源
2026-06-16 08:16:24,354 [INFO] src.desktop: 正在关闭桌面任务，释放资源
2026-06-16 08:16:24,788 [INFO] src.desktop: 桌面窗口已退出
PS E:\qclaw_workspace\video-scribe> python -m src.main
PS E:\qclaw_workspace\video-scribe> python -m src.main
PS E:\qclaw_workspace\video-scribe>

第二次之后没有看到：

text 复制代码

正在启动桌面窗口

说明程序甚至没有稳定进入桌面启动流程。

初步判断

这个问题不像是 VideoScribe 的视频处理线程未释放，因为关闭窗口时已经能看到：

text 复制代码

检测到桌面窗口关闭，准备取消任务并释放资源
正在关闭桌面任务，释放资源
桌面窗口已退出

同时检查残留进程时，没有发现明显的 Python 或 WebView2 残留进程。

更可能的原因是：

Windows 下 pywebview / Edge WebView2 在同一个 Python 进程或同一个终端上下文中反复启动和关闭时，内部 GUI 运行时状态没有完全恢复，导致下一次启动早退或无日志退出。

修复方案

将桌面程序改为 独立子进程启动。

现在用户仍然执行：

bash 复制代码

python -m src.main

但是内部流程变成：

text 复制代码

父进程: python -m src.main
  ↓
检测到这是客户端启动入口
  ↓
启动子进程: python -m src.main --desktop-child
  ↓
子进程启动 pywebview 桌面窗口
  ↓
用户关闭窗口
  ↓
子进程退出
  ↓
WebView2 / pywebview / 后台线程 / GUI 运行时状态全部随子进程释放
  ↓
父进程返回 PowerShell

下一次再执行 python -m src.main 时，会重新创建一个全新的桌面子进程，因此不会复用上一次 GUI 运行时状态。

关键代码

1. 增加内部桌面子进程参数

src/main.py 中增加隐藏参数：

python 复制代码

parser.add_argument(
    "--desktop-child",
    action="store_true",
    help=argparse.SUPPRESS,
)

这个参数只给程序内部使用，普通用户不需要关心。

2. 父进程拉起桌面子进程

src.main 现在只作为客户端入口，不再接收视频 URL 和处理参数。入口会拉起桌面子进程：

python 复制代码

if args.desktop_child:
    from .desktop import main as desktop_main
    desktop_main()
    return

command = [sys.executable, "-m", "src.main", "--desktop-child"]
print("VideoScribe 桌面程序已在独立进程中启动，关闭窗口后资源会随子进程释放。", flush=True)
completed = subprocess.run(command)
if completed.returncode != 0:
    print(f"桌面程序异常退出，退出码: {completed.returncode}", file=sys.stderr, flush=True)
    sys.exit(completed.returncode)

3. 桌面启动日志增加 PID

src/desktop.py 中增强日志：

python 复制代码

logger.info("正在启动桌面窗口: %s, pid=%s", ui_path, os.getpid())

这样可以确认每次启动都是新的子进程。

修复后的预期日志

再次运行：

bash 复制代码

python -m src.main

预期日志：

text 复制代码

VideoScribe 桌面程序已在独立进程中启动，关闭窗口后资源会随子进程释放。
2026-06-16 08:xx:xx [INFO] src.desktop: 正在启动桌面窗口: E:\qclaw_workspace\video-scribe\ui\index.html, pid=12345

关闭窗口后：

text 复制代码

2026-06-16 08:xx:xx [INFO] src.desktop: 检测到桌面窗口关闭，准备取消任务并释放资源
2026-06-16 08:xx:xx [INFO] src.desktop: 正在关闭桌面任务，释放资源
2026-06-16 08:xx:xx [INFO] src.desktop: 桌面窗口已退出

再次执行：

bash 复制代码

python -m src.main

应该看到新的 pid，并正常打开窗口。

资源释放策略

桌面端关闭时会执行：

python 复制代码

api.shutdown()

核心行为：

标记正在关闭。
调用 pipeline.cancel() 请求取消正在处理的任务。
等待后台任务线程最多 5 秒。
如果线程仍未退出，记录 warning。
清空窗口引用，避免后台线程继续调用 UI。
子进程退出后，由操作系统回收所有残留资源。

为什么不强杀线程

Python 无法安全强制终止任意线程，尤其是线程可能正在执行：

native 库调用
HTTP 请求
Whisper / faster-whisper 推理
WebView2 回调

强杀线程可能导致解释器状态、文件句柄或 native runtime 异常。

因此当前策略是：

text 复制代码

请求取消
  ↓
短暂等待
  ↓
如果还没退出，由桌面子进程整体退出时统一回收

这比在同一个 Python 进程中反复启动/销毁 GUI 更安全。

排查建议

如果后续仍然出现启动异常，优先检查：

1. 是否看到了父进程提示

text 复制代码

VideoScribe 桌面程序已在独立进程中启动，关闭窗口后资源会随子进程释放。

如果没有，说明还没进入子进程启动逻辑。

2. 是否看到了子进程 PID

text 复制代码

正在启动桌面窗口: ..., pid=12345

如果没有，说明子进程启动失败或过早退出。

3. 是否有异常退出码

text 复制代码

桌面程序异常退出，退出码: X

如果有，应根据退出码和前面的 traceback 继续排查。

4. 是否存在残留进程

PowerShell 中可检查：

powershell 复制代码

Get-Process python, pythonw, msedgewebview2 -ErrorAction SilentlyContinue |
  Select-Object ProcessName,Id,StartTime,Path

如果有异常残留，可手动结束后重试。

结论

这次问题的核心不是普通业务资源没有释放，而是桌面 GUI runtime 在同一进程/终端上下文中反复启动的稳定性问题。

通过把桌面窗口放进独立子进程，关闭窗口后让整个子进程退出，可以确保：

Python 后台线程释放
pywebview 状态释放
WebView2 运行时状态释放
下次启动是全新环境
同一 PowerShell 中反复启动更稳定

pywebview桌面程序关闭后同一终端再次启动无响应问题复盘