Community default. A company skill that explicitly supersedes samber/cc-skills-golang@golang-context skill takes precedence.

Go context.Context ベストプラクティス

context.Context は Go のメカニズムであり、キャンセレーション信号、デッドライン、リクエストスコープの値を API の境界を越えて、ならびにゴルーチン間で伝播させます。これはリクエストの「セッション」だと考えてください — 同じ単位の仕事に属するあらゆる操作を結びつけます。

ベストプラクティス要約

1. 同じコンテキストはリクエストライフサイクル全体を通じて伝播させなければなりません: HTTP ハンドラ → サービス → DB → 外部 API
2. ctx は第一パラメータでなければならず、ctx context.Context という名前をつけます
3. コンテキストを構造体に格納してはいけません — 関数パラメータで明示的に渡します
4. nil コンテキストを渡してはいけません — 不確実な場合は context.TODO() を使用します
5. cancel() は WithCancel/WithTimeout/WithDeadline の直後に defer で呼び出されなければなりません
6. context.Background() はトップレベル(main、init、テスト)でのみ使用しなければなりません
7. context.TODO() をプレースホルダーとして使用します。コンテキストが必要だと分かっているが、まだ持っていない場合
8. リクエストパスの途中で新しい context.Background() を作成してはいけません
9. コンテキスト値のキーは衝突を防ぐためにエクスポートされていない型でなければなりません
10. コンテキスト値はリクエストスコープのメタデータのみを保持しなければなりません — 関数パラメータは決して入れません
11. context.WithoutCancel(Go 1.21+) を使用します。親リクエストより長く生存する必要があるバックグラウンド作業を開始する場合

コンテキストの作成

コンテキスト伝播: コアプリンシパル

最も重要なルール: リクエストチェーン全体を通じて同じコンテキストを伝播させます。正しく伝播すると、親コンテキストをキャンセルすると、すべてのダウンストリーム作業が自動的にキャンセルされます。

// ✗ Bad — creates a new context, breaking the chain
func (s *OrderService) Create(ctx context.Context, order Order) error {
    return s.db.ExecContext(context.Background(), "INSERT INTO orders ...", order.ID)
}

// ✓ Good — propagates the caller's context
func (s *OrderService) Create(ctx context.Context, order Order) error {
    return s.db.ExecContext(ctx, "INSERT INTO orders ...", order.ID)
}

ディープダイブ

• Cancellation, Timeouts & Deadlines — キャンセレーションの伝播方法: 手動キャンセルには WithCancel、期間後の自動キャンセルには WithTimeout、絶対時刻のデッドラインには WithDeadline。並行コードでリスニングするパターン(<-ctx.Done())、AfterFunc コールバック、親リクエストより長く生存する必要がある操作(監査ログなど)に対する WithoutCancel。

• Context Values & Cross-Service Tracing — 安全なコンテキスト値パターン: 名前空間の衝突を防ぐためのエクスポートされていないキー型、コンテキスト値を使用する場合(リクエスト ID、ユーザー ID)と関数パラメータを使用する場合。トレースコンテキスト伝播: OpenTelemetry トレースヘッダ、ログ集約用の相関 ID、サービス境界を越えたコンテキストのマーシャリング/アンマーシャリング。

• Context in HTTP Servers & Service Calls — HTTP ハンドラコンテキスト: リクエストスコープのキャンセレーション用の r.Context()、ミドルウェア統合、サービスへの伝播。HTTP クライアントパターン: NewRequestWithContext、クライアントタイムアウト、コンテキスト対応リトライ。データベース操作: デッドラインを尊重するために常に *Context バリアント(QueryContext、ExecContext)を使用します。

クロスリファレンス

• → samber/cc-skills-golang@golang-concurrency スキルを参照して、コンテキストを使用したゴルーチンキャンセレーションパターン
• → samber/cc-skills-golang@golang-database スキルを参照して、コンテキスト対応のデータベース操作(QueryContext、ExecContext)
• → samber/cc-skills-golang@golang-observability スキルを参照して、OpenTelemetry でのトレースコンテキスト伝播
• → samber/cc-skills-golang@golang-design-patterns スキルを参照して、タイムアウトと復元力パターン

リンターで強制

多くのコンテキスト落とし穴は自動的にリンターで検出されます: govet、staticcheck。 → samber/cc-skills-golang@golang-lint スキルを参照して、設定と使用方法