ebSocket 频繁异常断开 (code=1006)

[Wei-sheng19]

Bug Report: WebSocket 频繁异常断开 (code=1006)

问题概述

Electron 前端渲染进程中的 WebSocket 连接 (createWebSocketStream.ts) 在长时间运行时会每隔 3-40 分钟异常断开，断开代码为 code=1006（Abnormal Closure）。断开后前端会自动重连，但问题反复发生，严重影响长任务体验。

环境信息

• 应用版本: AgnesCode
• 操作系统: macOS
• 后端进程: agnesd (从未崩溃，正常退出仅因 app 关闭/重启)
• 网络连接: 通过本地代理 (localhost:7897)
• 报告时间: 2026-07-13

复现步骤

1. 启动 AgnesCode
2. 进行对话/执行任务
3. 等待 3-40 分钟
4. 观察到 WebSocket 连接断开，前端自动重连
5. 问题循环出现

日志证据

1. WebSocket 断连记录 (2026-07-13)

[2026-07-13 16:19:49.326] websocket closed (code=1006)
[2026-07-13 16:31:03.905] websocket closed (code=1006)
[2026-07-13 17:24:49.432] websocket closed (code=1006)
[2026-07-13 17:38:43.728] websocket closed (code=1006)
[2026-07-13 18:29:59.382] websocket closed (code=1006)
[2026-07-13 18:35:40.842] websocket closed (code=1006)
[2026-07-13 19:11:22.448] websocket closed (code=1006)
[2026-07-13 19:41:39.433] websocket closed (code=1006)
[2026-07-13 19:59:36.282] websocket closed (code=1006)
[2026-07-13 20:13:34.207] websocket closed (code=1006)
[2026-07-13 20:48:07.537] websocket closed (code=1006)
[2026-07-13 21:07:20.847] websocket closed (code=1006)
[2026-07-13 21:26:35.830] websocket closed (code=1006)
[2026-07-13 21:39:34.536] websocket closed (code=1006)

总计: 14 次断连，平均约 19 分钟一次。

2. agnesd 进程状态

[2026-07-13 15:41:31] Starting agnesd (port 50974)
[2026-07-13 15:56:17] agnesd process exited with code 0 (app 关闭)
[2026-07-13 16:06:18] Starting agnesd (port 54935)
[2026-07-13 20:38:04] agnesd process exited with code 0 (app 关闭)
[2026-07-13 20:38:06] Starting agnesd (port 64996)

关键: agnesd 进程从未崩溃或异常退出，所有断连均发生在 Electron 前端渲染进程。

3. 断连与 agnesd 重启无关

• 14 次 WebSocket 断连期间，agnesd 进程始终保持存活
• agnesd 仅在 app 关闭/重启时正常退出（code 0）
• 断连由前端 createWebSocketStream.ts 触发

技术分析

WebSocket Close Code 1006 含义

Abnormal Closure — 连接非正常关闭，不是通过标准的 close handshake 断开的。
通常原因：网络层丢连接、服务端/代理超时、或对方进程崩溃。

问题定位

1. 后端 agnesd 正常 — 进程未崩溃，无 crash 记录
2. 断开发生在前端 — 日志来自 from renderer，属于 Electron 渲染进程
3. 经过本地代理 — 连接路径：前端 → localhost:54935 (agnesd) → localhost:7897 (代理) → 远程 API
4. 缺少心跳保活 — 未见 WebSocket ping/pong 机制

代理连接状态

当前代理 (localhost:7897) 活跃连接数: 36 (均为 ESTABLISHED)
agnesd 到代理的连接: 2 个 ESTABLISHED

代理本身运行正常，但 WebSocket 长连接未被保活。

可能原因

原因	可能性	说明
前端 WebSocket 缺少心跳保活	⭐⭐⭐⭐⭐	代理或上游 API 有 idle timeout，连接空闲后被断开
代理超时设置	⭐⭐⭐	本地代理 (7897) 可能对 WebSocket 有超时限制
macOS 网络策略	⭐⭐	macOS 对后台 socket 连接的空闲断开策略
网络波动	⭐⭐	部分短间隔断连 (3-5 分钟) 可能与网络有关

影响

• 长对话/长任务中用户体验差，频繁断连
• 每次断连后需要重新初始化 ACP 客户端
• 可能导致正在进行的任务中断或丢失状态

建议修复方向

1. 在 createWebSocketStream.ts 中添加 WebSocket 心跳机制

   • 定期发送 ping 帧 (建议每 30 秒)
   • 处理 pong 帧，确保连接活跃

2. 实现连接重试与状态恢复

   • 断连后自动重连并恢复会话状态
   • 增加指数退避重试策略

3. 添加连接健康检查

   • 监控 WebSocket 连接状态
   • 记录断连原因和频率，便于调试

临时 workaround

1. 关闭系统代理（如果不需代理上网）
2. 缩短单次任务时长，每 20 分钟内完成
3. 重启应用以重置连接

附件

• 完整日志: ~/Library/Application Support/AgnesCode/logs/main.log
• 诊断日期: 2026-07-13

[lore-cats]

Bug 报告：agnesd.exe 频繁崩溃（STATUS_STACK_BUFFER_OVERRUN，异常码 0xC0000409）

问题描述

agnesd.exe（AgnesCode 后端服务进程）频繁以 STATUS_STACK_BUFFER_OVERRUN 异常退出，崩溃发生在同一内存偏移地址，导致 ACP WebSocket 连接断开，应用无法正常使用。

运行环境

• 操作系统: Windows 11
• 应用程序: AgnesCode
• 后端二进制文件: D:/AgnesCode/resources/bin/agnesd.exe
• 编译时间戳: 2026-07-12 13:45:44 UTC（构建哈希：0x6A539A88）
• ACP 监听端口: 18668（主）、18681（初始）
• 用户账户: 本地 Windows 管理员账户
• 操作系统 & 架构： Windows 6.2.9200 x86_64
• 界面类型： UI
• 版本号： 1.42.0
• 已启用扩展： agnes_artifacts、developer、skills、summon、agnes_slide、todo、Extension Manager、tom、agnes_web_search、analyze、agnes_research、agnes_aigc、autovisualiser、chatrecall、code_execution、computercontroller、Microsoft Outlook、summarize、tutorial
• 服务商 & 模型： agnes - agnes-2.5-flash

崩溃时间线

在 2026-07-13 至 2026-07-14 约 1 小时内记录到 3 次崩溃：

序号	崩溃时间 (UTC+8)	进程 PID	退出码	错误偏移量
1	2026-07-13 23:29:14	22412 (0x578C)	3221226505 (0xC0000409)	0x00000000081071d6
2	2026-07-14 00:01:47	15152 (0x3B30)	3221226505 (0xC0000409)	0x00000000081071d6
3	2026-07-14 00:11:24	15476 (0x3C74)	3221226505 (0xC0000409)	0x00000000081071d6

关键发现：三次崩溃均发生在完全相同的指令偏移地址（0x81071d6），确认为同一代码路径下的确定性 Bug。

根因分析

异常类型

• 异常码：0xC0000409 = STATUS_STACK_BUFFER_OVERRUN
• 含义：Windows 栈金丝雀（Stack Canary）检测触发 — 函数栈缓冲区溢出保护检测到内存损坏
• 出错模块：agnesd.exe 自身（模块路径 = 应用路径），非第三方 DLL

崩溃过程

1. AgnesCode 前端正常启动，拉起 agnesd.exe 后端进程
2. ACP WebSocket 在端口 18668/18681 上建立连接
3. 用户创建新聊天会话并提交消息
4. 运行约 3 分钟后，agnesd.exe 执行到偏移 0x81071d6 处的代码
5. 检测到栈缓冲区溢出 → 操作系统强制终止进程
6. 前端检测到 WebSocket 断开（错误码 1006）
7. 前端尝试重连 → 失败（后端进程已死亡）
8. 前端进入无限重连循环，所有连接请求均失败

日志证据

Windows 事件查看器（应用程序日志）：
错误应用程序名称: agnesd.exe，版本: 0.0.0.0，时间戳: 0x6a539a88 错误模块名称: agnesd.exe，版本: 0.0.0.0，时间戳: 0x6a539a88 异常代码: 0xc0000409 错误偏移量: 0x00000000081071d6 错误应用程序路径: D:/AgnesCode/resources/bin/agnesd.exe 错误模块路径: D:/AgnesCode/resources/bin/agnesd.exe 报告 ID: 16024d92-4be1-4abe-a0e0-ce03df4810c8

AgnesCode 主日志节选：
`

[2026-07-14 00:11:26.827] websocket closed (code=1006, reason=n/a)
[2026-07-14 00:11:26.827] ACP client connection closed
[2026-07-14 00:11:26.828] submitMessage - ACP connection closed
[2026-07-14 00:11:26.906] agnesd process exited with code 3221226505 for port 18668
[2026-07-14 00:11:32.907] websocket connection failed before open
[2026-07-14 00:11:32.907] ACP WebSocket connection failed

`

可用崩溃转储文件

• agnesd.exe.22412.dmp（4.4 MB，2026-07-13 23:29:14）

agnesd.exe.22412.dmp

• agnesd.exe.15152.dmp（4.34 MB，2026-07-14 00:01:50）

agnesd.exe.15152.dmp

• agnesd.exe.15476.dmp（4.29 MB，2026-07-14 00:11:26）

agnesd.exe.15476.dmp

复现步骤

1. 通过桌面快捷方式启动 AgnesCode
2. 等待 ACP 连接初始化完成（端口 18668 或 18681）
3. 创建新的聊天会话
4. 提交一条消息
5. 等待约 3 分钟
6. agnesd.exe 崩溃，退出码 0xC0000409

注意：崩溃由正常聊天会话操作触发，可能与消息处理或会话管理相关。具体触发条件可能因会话内容而异。

截图

其他观察

• 已排除安全软件干扰：Windows 安全中心未拦截 agnesd.exe
• 已排除端口冲突：端口 18668/18681 仅被 agnesd 独占使用
• 已排除内存限制：崩溃稳定复现，非随机性内存不足
• 僵尸进程累积：反复崩溃后会产生多个残留 agnesd 进程（观察到同时存在 5+ 个）
• 更新检查失败（独立问题）：自动更新器因 HTTP 404 找不到 latest.yml，与崩溃无关

影响范围

• 应用崩溃后无法继续使用
• 用户无法发送消息或创建新会话
• 必须完全重启 AgnesCode（杀掉所有 agnesd 进程）才能恢复
• 未保存的消息和进行中的对话会丢失

附件

以下为随本报告提交的附件文件
打包zip

agnes-diagnostics-20260713-20260714-024545.zip

1. 脱敏日志 (AgnesCode_sanitized.log)
   • 完整应用日志（token 已替换为 REDACTED）
   • 大小：250 KB，共 2495 行

AgnesCode_sanitized.log

2. 错误日志 (AgnesCode_errors.log)
   • 仅提取错误/崩溃相关行，便于快速定位
   • 大小：40 KB，共 290 行

AgnesCode_errors.log

3. 崩溃转储文件 (Crash Dumps)
   • 文件列表：
     • agnesd.exe.22412.dmp（4.4 MB，2026-07-13 23:29:14）

agnesd.exe.22412.dmp

 - agnesd.exe.15152.dmp（4.34 MB，2026-07-14 00:01:50）

agnesd.exe.15152.dmp

 - agnesd.exe.15476.dmp（4.29 MB，2026-07-14 00:11:26）

4. Windows 事件日志
   • 来源：Windows 事件查看器 → 应用程序日志
   • 报告 ID：16024d92-4be1-4abe-a0e0-ce03df4810c8

请求协助

请调查 agnesd.exe 构建 0x6A539A88 中偏移 0x81071d6 处的代码。栈缓冲区溢出可能由以下原因引起：

• 无界栈缓冲区拷贝操作
• 数组/字符串操作缺少边界检查
• 函数返回地址被破坏
• 潜在的 use-after-free 或栈缓冲区溢出

若能通过崩溃 dump 文件获取完整调用堆栈，将极大帮助定位具体函数和代码路径。

---

报告日期: 2026-07-14