Golang context如何使用 实现协程控制与超时

golang context用于跨goroutine传递取消信号、截止时间和请求数据，通过context.background或WithCancel/Deadline/Timeout/Value创建并传递，各goroutine监听Done()通道实现协同取消，Value可传递请求级数据如请求ID，但应避免滥用以确保可维护性。

Golang context 旨在简化对跨 API 边界和 goroutine 之间请求范围值的处理，特别是用于取消操作、设置截止时间和传递请求相关值。它并非直接控制协程，而是提供一种优雅的方式来传递信号和数据，进而影响协程的行为。

Context 通过

context.Context

接口实现，核心功能包括：

• 取消信号： 允许父 Context 通知子 Context 及其关联的 goroutine 停止工作。
• 截止时间： 允许设置 Context 的超时时间，当超过该时间时，Context 将自动取消。
• 键值对： 允许存储请求范围的值，这些值可以在 Context 的整个生命周期内访问。

解决方案

1. 创建 Context：

   • context.Background()

     : 创建一个空的根 Context，通常用于顶层请求或没有父 Context 的情况。

   • context.TODO()

     : 类似于

     context.Background()

     ，但用于指示代码尚未确定使用哪个 Context。

   • context.WithCancel(parent)

     : 从父 Context 创建一个新的 Context，并返回一个取消函数。调用该函数将取消新的 Context 及其所有子 Context。

   • context.WithDeadline(parent, time)

     : 从父 Context 创建一个新的 Context，并设置截止时间。当到达截止时间时，Context 将自动取消。

   • context.WithTimeout(parent, duration)

     : 从父 Context 创建一个新的 Context，并设置超时时间。超时时间是从当前时间开始计算的。

   • context.WithValue(parent, key, value)

     : 从父 Context 创建一个新的 Context，并将键值对存储在其中。

2. 传递 Context：

   立即学习“go语言免费学习笔记（深入）”；

   将 Context 作为函数的第一个参数传递。这是一种约定，可以确保 Context 在整个调用链中可用。

   func processRequest(ctx context.Context, req *Request) error {     // ... }

3. 使用 Context：

   • 检查取消信号： 使用

     ctx.Done()

     获取一个只读的 channel。当 Context 被取消时，该 channel 将被关闭。可以使用

     select

     语句来监听该 channel，并在 Context 被取消时执行相应的操作。

     func worker(ctx context.Context) {     for {         select {         case <-ctx.Done():             fmt.Println("Worker: context cancelled")             return         default:             // 执行工作             fmt.Println("Worker: doing some work")             time.Sleep(time.Second)         }     } }

   • 检查截止时间： 使用

     ctx.Err()

     获取 Context 的错误。如果 Context 已被取消，

     ctx.Err()

     将返回一个非 nil 的错误。可以使用

     errors.Is(ctx.Err(), context.Canceled)

     或

     errors.Is(ctx.Err(), context.DeadlineExceeded)

     来判断取消的原因。

     func doSomething(ctx context.Context) error {     select {     case <-time.After(time.Duration(10) * time.Second):         // Operation completed successfully         return nil     case <-ctx.Done():         return ctx.Err() // Returns context.Canceled or context.DeadlineExceeded     } }

   • 获取键值对： 使用

     ctx.Value(key)

     获取存储在 Context 中的值。

     userID := ctx.Value("user_id").(string)

4. 取消 Context：

   • 对于使用

     context.WithCancel

     创建的 Context，调用返回的取消函数即可取消 Context。

   • 对于使用

     context.WithDeadline

     或

     context.WithTimeout

     创建的 Context，当到达截止时间或超时时间时，Context 将自动取消。

如何在多个 Goroutine 中使用 Context 取消操作？

Context 的取消功能是其核心优势之一，尤其在涉及多个并发 Goroutine 时。想象一个场景：你发起一个需要多个 Goroutine 协同完成的任务，但如果其中一个 Goroutine 失败了，你希望立即停止所有 Goroutine 的工作。Context 就可以派上用场。

首先，使用

context.WithCancel

创建一个 Context，并将其传递给所有相关的 Goroutine。每个 Goroutine 都应该监听 Context 的

Done()

channel。一旦 channel 关闭，Goroutine 就应该停止工作并清理资源。

func main() {     ctx, cancel := context.WithCancel(context.Background())     defer cancel() // 确保在 main 函数退出时取消 Context      // 启动多个 Goroutine，并将 Context 传递给它们     for i := 0; i < 5; i++ {         go worker(ctx, i)     }      // 模拟一个 Goroutine 失败的情况     time.Sleep(3 * time.Second)     fmt.Println("Main: cancelling context")     cancel() // 取消 Context，通知所有 Goroutine 停止工作      time.Sleep(time.Second) // 等待 Goroutine 退出     fmt.Println("Main: done") }  func worker(ctx context.Context, id int) {     for {         select {         case <-ctx.Done():             fmt.Printf("Worker %d: context cancelledn", id)             return         default:             fmt.Printf("Worker %d: doing some workn", id)             time.Sleep(time.Second)         }     } }

在这个例子中，

main

函数启动了 5 个

worker

Goroutine，并将 Context 传递给它们。3 秒后，

main

函数调用

cancel()

函数取消 Context。所有

worker

Goroutine 都会收到取消信号，并停止工作。

Context 的 Value 传递有什么实际应用场景？

Context 除了取消和超时控制外，还能携带键值对。这看似简单的功能，在某些场景下却能发挥巨大的作用。例如，你可以在 Context 中存储请求 ID、用户身份验证信息、跟踪 ID 等。这些信息可以在整个请求处理过程中访问，无需显式地在函数之间传递。

一个常见的应用场景是在 http 中间件中设置请求 ID，然后在后续的处理函数中使用该 ID 进行日志记录或跟踪。

func requestIDMiddleware(next http.Handler) http.Handler {     return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {         requestID := uuid.New().String()         ctx := context.WithValue(r.Context(), "request_id", requestID)         next.ServeHTTP(w, r.WithContext(ctx))     }) }  func myHandler(w http.ResponseWriter, r *http.Request) {     requestID := r.Context().Value("request_id").(string)     log.Printf("Request ID: %sn", requestID)     // ... }

需要注意的是，Context 的 Value 应该只用于传递请求范围的数据，而不是用于传递可选参数或配置信息。对于可选参数或配置信息，应该使用函数参数或全局变量。此外，Context 的 Value 应该是不可变的，以避免并发问题。

如何避免 Context 使用不当导致的问题？

Context 虽好，但使用不当也可能导致问题。一个常见的问题是过度使用 Context 的 Value。如果每个函数都从 Context 中获取大量数据，代码的可读性和可维护性将大大降低。

另一个问题是忘记取消 Context。如果一个 Goroutine 启动后没有正确地监听 Context 的

Done()

channel，即使 Context 被取消，该 Goroutine 仍然会继续运行，导致资源浪费甚至死锁。

为了避免这些问题，应该遵循以下最佳实践：

• 只在必要时使用 Context 的 Value。
• Context 的 Value 应该是不可变的。
• 确保每个 Goroutine 都监听 Context 的

  Done()

  channel。

• 使用

  contextcheck

  静态分析工具来检查 Context 使用是否正确。

此外，要注意Context传递的开销。虽然Context本身开销不大，但如果频繁创建和传递包含大量Value的Context，也会对性能产生一定影响。 在性能敏感的场景下，需要仔细评估Context的使用方式。