如何快速为Golang模块引入外部控制信号-Golang-PHP中文网

必须用 context.context 而非自定义 done chan，因其支持超时、嵌套取消、安全传递元数据，且被标准库广泛原生支持；withcancel、withtimeout、withdeadline 分别用于手动取消、相对超时、绝对截止时间；http handler 中应复用 r.context() 而非 context.background()；context.value 仅限存轻量、不可变、请求级元数据，键需自定义类型，避免滥用。

如何快速为golang模块引入外部控制信号

为什么必须用 `context.Context` 而不是自己传 `done chan struct{}`

直接传 done 通道看似简单，但无法携带超时时间、无法嵌套取消、不能安全传递请求元数据（比如 trace ID），且多个 goroutine 协作时容易漏关或重复关 channel。而 context.Context 是标准库统一抽象，所有 HTTP handler、database/sql、net/http.Client 等都原生支持它——你不用说服每个依赖库适配你的私有信号机制。

`context.WithCancel`、`context.WithTimeout`、`context.WithDeadline` 怎么选

三者本质都是返回一个新 Context 和对应的取消函数，区别只在触发条件：

context.WithCancel(parent)：纯手动控制，调用返回的 cancel() 就立刻取消
context.WithTimeout(parent, 5*time.Second)：从调用时刻起倒计时，适合 RPC 调用、数据库查询等“耗时上限明确”的场景
context.WithDeadline(parent, time.Now().Add(5*time.Second))：指定绝对截止时间，适合与外部系统对齐 deadline（如上游 HTTP 请求带 Timeout header）

注意：WithTimeout 底层就是 WithDeadline 的封装，不要混用；所有子 context 必须显式调用 cancel()，否则 parent 的资源（如 timer）不会释放。

在 HTTP handler 里怎么正确注入 `context.Context`

Go 的 http.ServeHTTP 默认把 request 的 context 透传给 handler，你不需要手动创建 root context：

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

func handler(w http.ResponseWriter, r *http.Request) {
	// r.Context() 已自带 cancel/timeout，来自 net/http 包内部管理
	ctx := r.Context()

	// 若需加额外约束（如限制 DB 查询最多 2s）
	ctx, cancel := context.WithTimeout(ctx, 2*time.Second)
	defer cancel() // 必须 defer，否则泄漏 timer

	// 传给下游函数
	result, err := db.Query(ctx, "SELECT ...")
	if err != nil {
		if errors.Is(err, context.DeadlineExceeded) {
			http.Error(w, "DB timeout", http.StatusGatewayTimeout)
			return
		}
		http.Error(w, "DB error", http.StatusInternalServerError)
		return
	}
	// ...
}

常见错误：在 handler 内部新建 context.Background() 替代 r.Context() —— 这会丢失请求生命周期绑定，导致超时/取消信号失效，也断开 tracing 链路。