Bug Report: Hanako 客户端 GPU 进程崩溃导致无法正常启动
基本信息
| 字段 |
内容 |
| 报告日期 |
2026-05-19 |
| 受影响版本 |
v0.216.20(稳定版)、v0.220.1(测试版) |
| 操作系统 |
Windows 11(64位) |
| 设备型号 |
MateBook X Pro |
| CPU |
Intel Core Ultra 7 155H @ 3.80 GHz |
| GPU |
Intel Arc Graphics(集成显卡,128 MB 专用显存) |
| 内存 |
32.0 GB |
| Electron 内核版本 |
未确认(随 Hanako 打包) |
问题描述
核心症状:Hanako 客户端双击桌面图标完全无反应,无窗口弹出,无进程残留。
命令行启动报错:
GPU process isn't usable. Goodbye.
exit_code=-2147483645
exit_code=-2147483645 对应十六进制 0x80000003,即 Windows 错误码 STATUS_BREAKPOINT,表明 GPU 进程在初始化阶段触发硬件断点异常。
复现条件
- 操作系统:Windows 11 + Intel Arc Graphics(Meteor Lake 平台集成显卡)
- 尝试直接启动 Hanako.exe(双击图标或命令行不带参数)
- 必现,100% 复现
已尝试的有效/无效方案
无效(问题依旧)
| 方案 |
详情 |
| 卸载重装 |
多次完整卸载(含删除 C:\Users\<用户名>\.hanako\ 和安装目录),重启后重装 |
| 版本回退 |
尝试 v0.220.1(测试版)和 v0.216.20(稳定版),均复现 |
| 驱动更新 |
通过华为电脑管家更新显卡驱动至最新 |
| 驱动回退 |
回退显卡驱动至较早版本 |
| 杀毒软件排除 |
关闭 Windows Defender,将 Hanako 安装目录加入排除项 |
--use-gl=swiftshader |
Chromium 内置 CPU 软件渲染器,同样无法启动 |
--disable-gpu --no-sandbox 组合 |
可启动但副作用严重(见下方"部分有效") |
部分有效(存在严重副作用)
唯一能启动的参数组合:
Hanako.exe --disable-gpu --no-sandbox
副作用:
- 软件界面严重卡顿,使用体验极差
- 豆包(doubao)Agent 无法使用:创建会话时报
500 Internal Server Error(/api/sessions/new)
- 工具执行不稳定:bash 命令频繁超时,沙箱误拦合法操作
日志片段(--disable-gpu --no-sandbox 启动后):
[23:40:41.779] [INFO] [server] engine initialized
[23:40:41.780] [INFO] [server] [proxy] outbound mode=system
Hanako v0.216.20 — started at 2026-05-19T15:40:41.780Z
[23:40:41.937] [INFO] [server] listening on :14500
[23:40:41.942] [INFO] [bridge] wechat started
(注:此模式下日志无 GPU 相关条目,因 GPU 已被完全禁用)
技术分析
根因判断
-
Intel Arc Graphics(Xe-LPG 架构)与 Chromium/Electron GPU 沙箱不兼容:
- Intel Arc 于 2023 年底随 Meteor Lake(Core Ultra)平台推出,是较新的 GPU 架构
- Chromium 的 GPU 进程沙箱机制在初始化该 GPU 时触发
STATUS_BREAKPOINT
- 连 SwiftShader(纯 CPU 软件渲染)也无法初始化,说明问题不仅限于 GPU 驱动层,而是 Chromium 渲染管线在本平台的初始化过程整体失败
-
排除项:
- 非配置文件损坏(全新安装后同样复现)
- 非特定版本问题(两个大版本均受影响)
- 非杀毒软件干扰
- 非 GPU 驱动版本问题(更新和回退均无效)
豆包 Agent 500 错误分析
豆包子代理(doubao)创建会话时报 500 错误,而 Hanako 主会话正常。该错误仅在 --disable-gpu 模式下出现,怀疑是 GPU 禁用后服务端内部状态不稳定导致的次级故障,与 GPU 崩溃同源。
附加信息
- Windows 硬件加速 GPU 调度:未测试关闭(待排查是否与此有关)
- Intel Arc 驱动版本:未记录(已更新至华为电脑管家提供的最新版)
- 是否使用外接显示器:否
- 其他 Electron 应用是否正常:未测试
建议修复方向
- 检查 Hanako 打包的 Electron 版本对 Intel Arc (Xe-LPG) GPU 的兼容性
- 考虑在启动时加入 GPU 兼容性检测,自动回退到软件渲染模式
- 单独测试
--disable-gpu-sandbox(保留 GPU 加速,仅禁用沙箱隔离)是否能绕过崩溃,如果可以,考虑将其作为 Arc GPU 的默认启动策略
- 排查 Chromium 的 GPU 驱动白名单是否包含 Intel Arc Graphics 的设备 ID
Bug Report: Hanako 客户端 GPU 进程崩溃导致无法正常启动
基本信息
问题描述
核心症状:Hanako 客户端双击桌面图标完全无反应,无窗口弹出,无进程残留。
命令行启动报错:
exit_code=-2147483645对应十六进制0x80000003,即 Windows 错误码STATUS_BREAKPOINT,表明 GPU 进程在初始化阶段触发硬件断点异常。复现条件
已尝试的有效/无效方案
无效(问题依旧)
C:\Users\<用户名>\.hanako\和安装目录),重启后重装--use-gl=swiftshader--disable-gpu --no-sandbox组合部分有效(存在严重副作用)
唯一能启动的参数组合:
副作用:
500 Internal Server Error(/api/sessions/new)日志片段(
--disable-gpu --no-sandbox启动后):(注:此模式下日志无 GPU 相关条目,因 GPU 已被完全禁用)
技术分析
根因判断
Intel Arc Graphics(Xe-LPG 架构)与 Chromium/Electron GPU 沙箱不兼容:
STATUS_BREAKPOINT排除项:
豆包 Agent 500 错误分析
豆包子代理(doubao)创建会话时报 500 错误,而 Hanako 主会话正常。该错误仅在
--disable-gpu模式下出现,怀疑是 GPU 禁用后服务端内部状态不稳定导致的次级故障,与 GPU 崩溃同源。附加信息
建议修复方向
--disable-gpu-sandbox(保留 GPU 加速,仅禁用沙箱隔离)是否能绕过崩溃,如果可以,考虑将其作为 Arc GPU 的默认启动策略