mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-27 21:03:16 +00:00
324181d663
## 现象 systemd 每次都报 `State 'stop-sigterm' timed out. Killing.` 进程组里 23 个子进程插件**全退完了**，最后那条 `[homed] stopped` 仍打不出来，然后被 SIGKILL。 ## 根因（算出来的，不是猜的） 单个插件的 Stop 最坏预算： 5s（CallContext plugin.stop）+ 5s（等 exited）+ 2s（Kill 后收割）= 12s 串行停 23 个 ⇒ 23 × 12s = 276s，而 systemd 只给 90s。 ⇒ 关停必然超时。线上每一条 stop 记录都是 timed out，无一例外。 ## 改法 StopAll 改为并行：取插件快照 + 各自的 SDK 句柄后**立即释放 registry 锁**， 每个插件一个 goroutine，等全部完成再释放共享段。 三处必须小心的点（都是并行化引入的新风险）： 1. **先释放 registry 锁再并行停**。p.Stop() 会触发 markExited → onExit → ReclaimOwner，那条链要读共享内存段。 持着锁并行跑，若某插件的 onExit 需要拿 registry 锁（摘通道等） 就是自死锁。 2. **stop handler 的快照要在清空 sdkRefs 之前取**。handler 挂在 PluginSDK 上（r.sdkRefs），先清空就再也拿不到了。 3. **单个插件 panic 不带崩关停**（那会让剩下的插件全停不掉）， 也不静默吞（留日志）。 ## 判据：5 条 + 3 组变异 + race - TestStopAllStopsInParallel：8 个插件各 120ms，串行 960ms / 并行 120ms。 判据直接量耗时，串行实现必然变红（实测串行时 962ms）。 - TestStopAllSurvivesPanickingPlugin：panic 不外冒、其它插件照停、不死锁 （带 10s 超时，死锁会超时而不是挂住测试） - TestStopAllFreezesAutoRestart / StopsEachPluginExactlyOnce： 冻结自动重启、每个插件恰好 Stop 一次（重复会二次释放共享段） - TestStopAllRunsStopHandlerBeforeStop：handler 必须先于 Stop， 走真实的 PluginSDK.RegisterStopHandler 路径 变异：退回串行 → 判红并打出实测耗时；去掉 handler 调用 → 顺序判红； 假装并行只清空 → 4 条判红。 `-race` 通过（并行化必须验锁，这是本次改动的头号风险）。 全量 41 包绿。