Go言語のcontextパッケージとエラーハンドリングの関係を解説！初心者でもわかる使い方

1. contextパッケージとは？

1. contextパッケージとは？

Go言語のcontextパッケージは、複数の関数や処理の間で「処理をキャンセルする」「処理の期限を設定する」などの情報を共有するための仕組みです。

これは、特にWebサーバーやネットワーク処理など、長時間かかる処理を途中で止めたいときに役立ちます。

2. なぜエラーハンドリングと関係があるの？

2. なぜエラーハンドリングと関係があるの？

contextは処理の中断を知らせるために使われますが、その中断はエラーとして扱います。つまり、処理がキャンセルされたりタイムアウトになった場合は、context.Canceledやcontext.DeadlineExceededという特別なエラーが返ってきます。

これらのエラーを受け取ることで、プログラムは「処理が途中で止まった」ことを認識し、適切な対応ができるようになります。

3. 簡単なキャンセルの例

3. 簡単なキャンセルの例

次のコードは、context.WithCancelを使って、処理をキャンセルする例です。

package main

import (
    "context"
    "fmt"
    "time"
)

func main() {
    ctx, cancel := context.WithCancel(context.Background())

    go func() {
        time.Sleep(2 * time.Second)
        cancel() // 2秒後にキャンセルを通知
    }()

    select {
    case <-time.After(5 * time.Second):
        fmt.Println("処理が完了しました")
    case <-ctx.Done():
        fmt.Println("処理がキャンセルされました:", ctx.Err())
    }
}

この例では、2秒後にキャンセルの合図が送られ、ctx.Done()が反応します。そのときのエラーがctx.Err()で取得でき、「処理がキャンセルされました」と表示されます。

4. タイムアウト付きのcontext例

4. タイムアウト付きのcontext例

今度は、処理に時間制限（タイムアウト）を設ける例です。context.WithTimeoutを使います。

package main

import (
    "context"
    "fmt"
    "time"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
    defer cancel()

    select {
    case <-time.After(5 * time.Second):
        fmt.Println("処理が完了しました")
    case <-ctx.Done():
        fmt.Println("処理がタイムアウトしました:", ctx.Err())
    }
}

ここでは3秒でタイムアウトし、5秒かかる処理は途中で止まります。エラーとしてcontext.DeadlineExceededが返されます。

5. contextのエラーを使った実際のエラーハンドリング

5. contextのエラーを使った実際のエラーハンドリング

実際にcontextのエラーを使うときは、ctx.Err()をチェックして、どんな理由で中断されたのかを判断します。例えばこうです。

if err := ctx.Err(); err != nil {
    if err == context.Canceled {
        fmt.Println("処理はキャンセルされました")
    } else if err == context.DeadlineExceeded {
        fmt.Println("処理はタイムアウトしました")
    } else {
        fmt.Println("その他のエラー:", err)
    }
}

こうすることで、キャンセルとタイムアウトの違いを分けて処理できます。

6. 覚えておきたいポイント

6. 覚えておきたいポイント

• Goのcontextパッケージは、処理のキャンセルやタイムアウトを伝えるための仕組み
• キャンセルやタイムアウトはcontext.Canceledやcontext.DeadlineExceededというエラーで通知される
• エラーハンドリングでctx.Err()を確認し、適切な対応を行うことが大切
• 特にWebやネットワーク処理で長時間の処理を安全に中断するためによく使われる

まとめ

まとめ

contextとエラーハンドリングの関係を深く理解するために

今回の記事では、Go言語のcontextパッケージがどのように動作し、エラーハンドリングとどのように結びついているのかを体系的に学びました。contextは「ただの便利ツール」ではなく、長時間の処理や複数の関数が連携する場面で欠かせない仕組みであり、特にキャンセルやタイムアウトが発生した際に、明確なエラーとして通知される点がとても重要です。 初心者が最初につまずきやすいのは、contextが返すエラーが「処理中に発生したエラー」ではなく「処理を続けられない理由」である点です。つまり、context.Canceledはユーザーやプログラム側の都合による中断、context.DeadlineExceededは時間切れ、というように、それぞれが明確な意味を持っています。

また、contextは複数の処理全体で共有されるため、一つの合図が複数の関数に影響することがあります。例えばWebサーバーでは、ユーザーがページ遷移やキャンセル操作を行った瞬間、contextからキャンセルの合図が送られ、関連する処理がすべて安全に停止します。この仕組みにより、不要な処理を無駄に続けることなく、サーバー資源を効率よく保つことができます。 こうした動きは、エラーハンドリングの正しい理解がないと捉えにくいため、今回の例を通してcontextのエラーをしっかり読み取れるようになることが大きな一歩になります。

contextのキャンセルとタイムアウトを使った実践的なサンプル

ここでは、contextを使った実践的なサンプルをもう一つ紹介します。これは複数の処理を同時に動かしつつ、途中でキャンセルの合図が来たときに全体を安全に止める例です。

package main

import (
    "context"
    "fmt"
    "time"
)

func longTask(ctx context.Context, name string) {
    for i := 1; i <= 5; i++ {
        select {
        case <-ctx.Done():
            fmt.Println(name, "は中断されました:", ctx.Err())
            return
        default:
            fmt.Println(name, "を実行中...", i)
            time.Sleep(1 * time.Second)
        }
    }
    fmt.Println(name, "が正常に完了しました")
}

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
    defer cancel()

    go longTask(ctx, "処理A")
    go longTask(ctx, "処理B")

    time.Sleep(6 * time.Second)
    fmt.Println("メイン処理終了")
}

このサンプルでは、複数の処理が同じcontextを共有しており、3秒でタイムアウトした瞬間、両方の処理が中断されます。「途中でやめなければならない」という場面は実際のソフトウェアでもよくあり、contextを理解しておくことで、効率的で安全なコードを書くことができるようになります。

contextのエラーを扱うための思考法

contextを使ったエラーハンドリングで特に大切なことは「中断された理由を正しく読み取る」ことです。キャンセルなのか、タイムアウトなのか、その他の理由によるものなのかを切り分けることで、次に取るべき行動を適切に選ぶことができます。 例えばユーザーが明示的にキャンセルした場合には処理を中断してよいですが、タイムアウトの場合は「どうすれば改善できるか」「時間を延ばすべきか」「新しい対処が必要か」など、考えるべきポイントが異なるためです。

こうした細やかな判断ができるようになると、contextを活用したエラーハンドリングが強力な味方になり、Web開発やバッチ処理、ネットワーク通信など、さまざまな分野で安定したプログラムを作れるようになります。 Go言語を学び始めた初心者にとっても、この仕組みを早い段階で理解しておくと、後々のコード設計が格段にしやすくなります。