Go言語のエラーと例外の基本！初心者がよく出会うエラーとその対処法まとめ

1. Go言語の「エラー」とは？

1. Go言語の「エラー」とは？

Go言語では、プログラム中で問題が起きたときに「エラー（error）」という特別な値を使って知らせます。

たとえば、ファイルを開こうとしたときに、そのファイルが存在しなかった場合などにエラーが発生します。エラーが起きても、Go言語ではプログラムが勝手に止まることはなく、自分でエラーをチェックして処理する必要があります。

2. エラーの基本的な書き方と確認方法

2. エラーの基本的な書き方と確認方法

Go言語では、関数の戻り値としてエラーを受け取ります。エラーがあるかどうかをif文でチェックして処理します。

次のようなコードで確認できます。

package main

import (
    "fmt"
    "os"
)

func main() {
    file, err := os.Open("sample.txt")
    if err != nil {
        fmt.Println("エラーが発生しました:", err)
        return
    }
    defer file.Close()
    fmt.Println("ファイルを正常に開けました")
}

このコードでは、os.Open関数でファイルを開こうとしています。errにエラーの内容が入るので、それをチェックしてから処理します。

3. 初心者がよく出会うGo言語のエラーとその対処法

3. 初心者がよく出会うGo言語のエラーとその対処法

Go言語を始めたばかりの人がよく出会うエラーをいくつか紹介し、その意味と対処方法を説明します。

3-1. undefined: 〇〇

undefinedというエラーは、使おうとした変数や関数が定義されていないときに出ます。

undefined: x

これは、「xという名前のものはまだ作っていませんよ」という意味です。

対処法：変数や関数を使う前に、正しく定義しておく必要があります。

3-2. cannot use 〇〇 (type string) as type int

これは、「文字列型（string）の値を、整数型（int）として使おうとしていますよ」という型のエラーです。

cannot use "10" (type string) as type int

対処法：型変換（キャスト）を行う必要があります。例えば、文字列から整数に変換するには、strconv.Atoi関数を使います。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    str := "10"
    num, err := strconv.Atoi(str)
    if err != nil {
        fmt.Println("変換に失敗しました:", err)
        return
    }
    fmt.Println("整数に変換できました:", num)
}

3-3. panic: runtime error

panicとは、Go言語で重大なエラーが発生したときに出るメッセージです。

例えば、配列の範囲外にアクセスしたときなどに起こります。

panic: runtime error: index out of range

対処法：配列やスライスにアクセスする前に、インデックスが範囲内にあるか確認しましょう。

4. Goのエラーは「例外処理」とは違う？

4. Goのエラーは「例外処理」とは違う？

他の言語、例えばJavaやPythonなどでは、tryやcatchという構文を使って「例外処理（エクセプションハンドリング）」を行います。

ですが、Go言語ではこのような仕組みは使わず、「エラーの値を自分でチェックして対応する」という方針をとっています。

このようにすることで、エラー処理が明示的になり、プログラムの動作が分かりやすくなるという利点があります。

5. 独自のエラーを作るには？

5. 独自のエラーを作るには？

Go言語では、自分でエラーを作ることもできます。errors.Newという関数を使って、エラーメッセージを作ります。

package main

import (
    "errors"
    "fmt"
)

func checkAge(age int) error {
    if age < 18 {
        return errors.New("18歳未満は登録できません")
    }
    return nil
}

func main() {
    err := checkAge(16)
    if err != nil {
        fmt.Println("エラー:", err)
        return
    }
    fmt.Println("登録完了です！")
}

このように、年齢チェックなどの場面で自分でエラーを作ることで、より細かい制御が可能になります。

6. エラーが出たらどうすればいい？初心者向けチェックポイント

6. エラーが出たらどうすればいい？初心者向けチェックポイント

プログラミング初心者の方がエラーに出会ったとき、どう対応すればよいかのポイントを紹介します。

• エラーメッセージをよく読む：英語の文章でも、どの行でどんな問題があるかを示しています。
• スペルミスをチェック：変数や関数の名前を間違えていないか確認しましょう。
• 型（データの種類）に注意：文字列・整数など、異なる型を混ぜないように気をつけましょう。
• よくある文法ミス：波カッコ{}やセミコロンが正しく使われているかチェックしましょう。
• ネット検索で調べる：エラーメッセージをコピーして検索するのも効果的です。

まとめ

まとめ

Go言語のエラーと例外の考え方について学んできて分かるように、この言語では「例外を投げてキャッチする」という仕組みよりも、「関数の戻り値としてerror型を返し、呼び出し側がきちんと確認する」というスタイルがとても重視されています。これは最初は少し面倒に感じるかもしれませんが、どこでエラーが発生しうるのか、どの場所でエラー処理をしているのかがコード上でとても分かりやすくなるという大きな利点があります。特にファイル処理やネットワーク処理、文字列変換、数値変換など、Go言語の標準ライブラリを使った実装では、ほとんどの関数が「値」と「error」をセットで返す形になっているため、この書き方に慣れておくことが、今後のGo言語プログラミングを進めるうえでの大きな土台になります。

また、初心者が最初につまずきやすい「undefined: ○○」というエラーや、「cannot use ○○ (type string) as type int」というような型に関するエラーは、Go言語が静的型付けであることを理解するきっかけにもなります。コンパイル時に間違いをしっかり指摘してくれるおかげで、実行してから気づくバグを減らせるため、最初はエラーメッセージの多さに驚いても、それは決して悪いことではありません。むしろ、どんなミスをしたのかを丁寧に教えてくれる頼もしいガイドのような存在だと考えると、エラーを読むこと自体が学習の一部であり、Go言語の文法や型のルールを体で覚えていく良い機会になるはずです。

さらに、「panic: runtime error」のような実行時エラーは、配列やスライスの範囲外アクセス、nilポインタの参照など、プログラムの安全性に関わる重大な問題が起きたときに発生します。panicは通常のerrorとは異なり、そのままにしておくとプログラム全体が強制終了してしまうため、本番運用のコードではなるべく発生させないように意識した設計が大切です。インデックスのチェックを丁寧に行ったり、nilかどうかを確かめてから処理したりすることで、多くのpanicは事前に防ぐことができます。Go言語のエラーとpanicの違いを理解しておけば、どの場面で「errorを返すべきか」、どの場面で「panicを使ってよいか」を判断できるようになり、より堅牢なアプリケーション設計へとつながっていきます。

そして、errors.Newやfmt.Errorfなどを使って自分でエラーを作成する方法も、Go言語ならではの重要なポイントです。関数の中で条件に合わない入力を受け取ったときや、外部サービスからのレスポンスが正しくない場合など、「これは通常の成功パターンではない」という状況を、わかりやすいメッセージとともに呼び出し元に伝えることができます。こうした独自エラーを活用すると、どの処理で失敗したのかがログに分かりやすく残るようになり、開発中のデバッグや運用時のトラブルシューティングが一気に楽になります。Go言語のエラー処理は、一見地味に見えても、実は開発体験を支えるとても大切な仕組みだといえるでしょう。

エラーに遭遇したときの心構えとして、エラーメッセージを最後までしっかり読む習慣をつけておくことも大切です。どの行で、どの識別子や型が原因で、どういった不整合が起きているのかが、メッセージの中に必ず手がかりとして書かれています。英語に慣れていないと最初はとっつきにくいかもしれませんが、何度も見ているうちに「undefined」「cannot use」「index out of range」といったおなじみの単語や表現が読めるようになり、「ああ、これはあのときと同じ間違え方だな」という感覚で素早く修正できるようになります。エラーメッセージを敵だと思わず、丁寧に教えてくれる相棒だと捉え直すことで、Go言語の学習はぐっと楽しくなります。

もう一つ重要なのは、エラー処理をコード全体の流れの中でどう配置するかという視点です。毎回同じようなif err != nilのパターンが並びすぎると、ロジックが読みにくくなってしまう場合があります。そういうときには、ヘルパー関数を用意してエラー処理部分を共通化したり、上位の関数にエラーをそのまま返して任せたりする設計を検討するのも有効です。また、ログ出力のルールを決めておくことで、エラー発生時の情報を一貫した形で記録でき、後から見返して原因を追いやすくなります。Go言語では標準パッケージにもlogやerrorsなど、エラー関連の便利な機能が揃っているので、組み合わせて使うことで現場で通用するエラー処理のスタイルを身につけることができます。

初心者の段階では、エラーを見て落ち込むよりも、「なぜこのエラーが出たのか」「どのように対処すれば良いのか」を一つひとつ紐解いていく姿勢がとても大切です。今回学んだような代表的なエラーメッセージや、型の不一致、未定義の変数、範囲外アクセスなどのパターンを頭の片隅に入れておくだけでも、実際に開発するときに同じミスを減らせます。Go言語のエラーと例外の違い、error型の戻り値、panicの扱い方、独自エラーの作り方といった基礎がしっかり理解できていれば、これからファイル操作、HTTP通信、データベースアクセスなど、より実践的なプログラムに挑戦したときにも、冷静に問題を切り分けてエラーと付き合っていくことができるでしょう。

エラー処理の基本形をもう一度コードで確認しよう

最後に、Go言語らしいエラー処理の流れをまとめたサンプルコードを紹介します。ファイルを開き、内容を扱うような場面は実践でもよく登場するので、パターンとして覚えておくと役立ちます。

package main

import (
    "errors"
    "fmt"
    "os"
)

func readConfig(path string) error {
    file, err := os.Open(path)
    if err != nil {
        // 元のエラーに説明を付け足して返す
        return fmt.Errorf("設定ファイルを開けませんでした: %w", err)
    }
    defer file.Close()

    // 本来はここで設定ファイルを読む処理を行う
    // 今回は説明用のため、簡単なメッセージだけにしています
    fmt.Println("設定ファイルを正常に読み込みました")
    return nil
}

func main() {
    err := readConfig("config.yaml")
    if err != nil {
        // 特定のメッセージを判定したい場合はerrors.Isなども利用できます
        if errors.Is(err, os.ErrNotExist) {
            fmt.Println("ファイルが存在しません。パスを確認してください。")
        } else {
            fmt.Println("エラーが発生しました:", err)
        }
        return
    }
    fmt.Println("アプリケーションを続行します。")
}

このサンプルでは、エラーを単に表示するだけでなく、fmt.Errorfと%wを使って元のエラーをラップしつつ、より分かりやすいメッセージを追加しています。呼び出し側ではerrors.Isを使って、特定の種類のエラーかどうかを判定することもできるため、状況に応じた対処が可能になります。Go言語で本格的なアプリケーションを作るときには、このようなパターンを積み重ねながら、自分なりのエラー処理のスタイルを作っていくことが重要です。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Go言語ではエラー処理に例外（try-catch）を使わないのですか？

はい、Go言語では他の言語のようなtry-catchによる例外処理ではなく、関数の戻り値としてerror型を使ってエラー処理を行います。この方式により、どこでエラーが起きるか明示的に記述できるのが特徴です。

Go言語でよく見る「undefined: ○○」エラーの意味は何ですか？

「undefined: ○○」というエラーは、その変数や関数がまだ定義されていない状態で使用しようとしたときに表示されるエラーメッセージです。定義漏れが原因です。