Go context.Cause 和 Err 返回值为什么可能不同

在 Go 的取消链路里，ctx.Err() 和 context.Cause(ctx) 解决的不是同一个问题：前者给出稳定的取消类别，后者尽量保留“为什么取消”的具体错误。使用 context.WithCancelCause 后，常见结果就是 Err() 返回 context.Canceled，而 Cause() 返回你传入的业务错误；没有设置自定义原因时，两者才可能相同。

先把 Err 和 Cause 放在同一个例子里

最小写法是用 WithCancelCause 得到一个带原因的取消函数。调用方传入错误，接收方分别读取两个接口：

package main

import (
    "context"
    "errors"
    "fmt"
)

func main() {
    ctx, cancel := context.WithCancelCause(context.Background())
    defer cancel(nil) // 兜底释放取消树；已经取消时不会覆盖原原因。

    cause := errors.New("上游租约已失效")
    cancel(cause) // 记录具体原因，同时关闭 ctx.Done()。

    fmt.Println(ctx.Err() == context.Canceled)
    fmt.Println(context.Cause(ctx))
}

这里的第一个输出是 true，第二个输出是“上游租约已失效”。Err() 的设计重点是让不同库之间有统一判断方式；Cause() 则把取消时的上下文信息留给日志、指标或上层诊断。

没有自定义原因时，两个返回值为什么会一样

context.Cause 在没有通过 CancelCauseFunc 设置原因时，会退回到 ctx.Err() 的结果。因此普通的 WithCancel、手动调用 WithCancelCause 后传入 nil，通常都只能得到 context.Canceled。

超时也要区分两种构造方式：

不要把 Cause 当成另一套取消状态码。判断“是否超时”仍然用 errors.Is(err, context.DeadlineExceeded)；如果需要知道是哪个下游或哪条策略触发，再把 context.Cause(ctx) 写入诊断信息。

父子 Context 的第一次取消会锁定原因

Context 是树状关系。父节点先带着原因取消时，子节点会继承父节点的 cause；如果子节点先独立取消，它可以保留自己的原因，之后父节点再取消也不会覆盖已经确定的子节点原因。

parent, stopParent := context.WithCancelCause(context.Background())
defer stopParent(nil) // 只负责释放资源，不覆盖已确定的原因。

child, stopChild := context.WithCancelCause(parent)
defer stopChild(nil)

stopChild(errors.New("子任务主动放弃")) // 子节点先取消，原因归子节点。
stopParent(errors.New("请求整体超时")) // 父节点随后取消，不覆盖 child 的 cause。

fmt.Println(context.Cause(child))

这个例子里子节点的 cause 是“子任务主动放弃”。反过来，如果先调用 stopParent，子节点的 Cause 就会继承“请求整体超时”。所以排查取消问题时，除了看错误文本，还要确认哪个 Context 先进入了取消状态。

业务代码里应该如何分工使用

推荐把 Err 放在控制流程里，把 Cause 放在解释流程里。比如接口层只需要根据 context.Canceled 或 context.DeadlineExceeded 选择响应策略；日志层再记录 cause，避免把内部业务错误直接当成公共错误码。

还有三个容易忽略的点：

• 调用 cancel 不会等待工作协程停止，工作函数仍要监听 ctx.Done() 并及时返回。
• 同一个 Context 已经取消后，再次调用取消函数不会替换原因，所以不要把它当作可变错误槽。
• 创建了 WithCancel、WithTimeout 或 cause 版本的 Context 后，仍应在合适位置 defer cancel(...)，以便释放关联资源。

实际排查可以按“先看 Err 分类、再看 Cause 细节、最后追取消先后”的顺序进行。这样既不会因为自定义错误破坏公共接口判断，也不会丢失定位上游问题所需的信息。

相关问题

context.Cause(ctx) 一定和 ctx.Err() 不一样吗？

不一定。普通取消或没有设置自定义原因时，Cause 会返回与 Err 相同的取消错误；只有 cause 版本记录了具体错误时，二者才会体现不同层次的信息。

应该用 Cause 代替 Err 做超时判断吗？

不建议。超时、取消属于通用控制信号，应优先用 Err 或 errors.Is 判断；Cause 用于补充诊断原因。