[refactor][P3] Future.Wait(nil ctx) 直接 nil 接口 panic，未按簇内口径兜底

来源：2026-11-11 全矩阵深度代码审查（6 路并行扫描约 24 万行 Go）。判定已复核；行号基于 2026-11-11 的 main，动手前请核对现场。
归档索引：#95（本仓重构 backlog）

位置

future.go:78-79

证据

select {
case <-ctx.Done():          // ctx == nil ⇒ nil interface 方法调用 panic
case <-f.done:
}

concurrency 的 retry/loop/syncx/breaker/Handle.WaitUpTo 全部「nil 按 Background」，Future 是 workflow 的导出结果句柄、Wait 是导出方法（嵌套流程把父 ctx 透传进来的调用链上 nil 会在更早处炸，但直调 Future 的消费方无防护）。

建议

Wait 入口补 if ctx == nil { ctx = context.Background() }，与其余导出方法对齐；补一条 nil-ctx 直调测试（当前零覆盖）。

Merge pull request #100 from oekit/fix/sweep-20261112

已在 v0.11.0 修复并发布 ✅

变更内容

本条修复（在 v0.11.0 的版本节里定位到）：

行为缺陷三连与样板收编：四类 Flow 的注册/快照/传播样板抽取 flowBase/flowHooks 公共基座，公开 API 形状不变（[refactor][P1] 四个 Flow 类型的注册/快照/传播样板逐字复制——应抽 flowBase 内嵌 #94）；AsyncFlow 三入口的 [async] RunAsyncWithResults 把被兄弟失败砍掉的任务记为 Error:nil——「成功」与「未执行/被打断」不可区分，部分副作用被静默记成功 #82 豁免判据与 [async] RunAsync 父 ctx 取消/超时后 Future.Wait 静默返回 nil——任务全部未执行或被打断却报「成功」，与 Run 已修的「假成功」语义相悖 #35 取消兜底收敛为 errAggregator 单源，Run 判据对齐文档承诺的调用方 context（[refactor][P2] AsyncFlow 的 Run/RunAsync/RunAsyncWithResults 豁免+兜底编排三写 #96）；panic→error 转换 5 处统一改走 pkg errors.Recovered 单源，panic 值是 error 时 errors.Is/As 身份透传、栈保留在文本与 Stack 字段（[refactor][P2] panic→error 转换 5 处 fmt.Errorf(%v) 丢身份——本簇该形态的最大聚集点 #97）；Future.Wait(nil ctx) 按簇内口径兜底 context.Background，不再 nil 接口 panic（[refactor][P3] Future.Wait(nil ctx) 直接 nil 接口 panic，未按簇内口径兜底 #98）；HookManager.Add 加锁同步，Run 期间注册 Hook 不再是数据竞争，契约注释同步改写（[refactor][P3] HookManager.Add 与 Run 的数据竞争契约被相邻 API 的承诺掩蔽 #99）。Go 地板抬至 1.26.0；显式依赖 pkg v0.45.0，logx 抬至 v0.10.0。

该版本 `v0.11.0` 的其余变更

关联问题单：workflow#94、workflow#96、workflow#97、workflow#98、workflow#99。

Release: https://github.com/oekit/workflow/releases/tag/v0.11.0

Navigation Menu

Repository navigation

[refactor][P3] Future.Wait(nil ctx) 直接 nil 接口 panic，未按簇内口径兜底 #98

位置

证据

建议

变更内容

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[refactor][P3] Future.Wait(nil ctx) 直接 nil 接口 panic，未按簇内口径兜底 #98

Description

位置

证据

建议

Activity

zy84338719 commented on Nov 11, 2026

变更内容

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions