Go言語の多重エラー処理（複数エラー）のパターン集！初心者でもわかる安全なエラーハンドリング
生徒
「先生、Go言語で複数のエラーが同時に起きたときって、どうやって処理したらいいんですか？」
先生
「いい質問ですね。Go言語では、ひとつの処理で複数のエラーが起きることもあります。そんな時は『多重エラー処理』を使って、全てのエラー情報をまとめて扱う方法があります。」
生徒
「どうやって複数のエラーをまとめるんですか？初心者でもわかるように教えてください！」
先生
「はい、これから基本的なやり方やコード例を使って丁寧に説明しますね！」
1. 多重エラー処理とは？
プログラムではエラーが発生すると、その原因を特定して適切に対処する必要があります。多重エラー処理とは、一つの関数や処理の中で起きた複数のエラーを「まとめて一括で扱う」ための考え方・テクニックのことです。Go言語のエラーハンドリングでは、この複数エラーをどう整理するかがとても大事になります。
たとえば、会員登録フォームを考えてみましょう。ユーザー名・メールアドレス・パスワードを一度に入力してもらうとき、それぞれに「未入力」「形式が間違っている」といったエラーが同時に起きる可能性があります。このとき、最初に見つかったエラーだけを返してしまうと、ユーザーは何度も入力し直さなければならず、あとから他のエラーに気づくことになります。
そこで、Go言語の多重エラー処理では「見つかったエラーをひとまず全部集めておき、まとめて返す」という考え方をします。こうすると、ユーザーには「名前が未入力」「メールアドレスが空」「パスワードが短い」といった複数のエラーを一度に伝えられ、開発者にとっても原因をまとめて確認しやすくなります。
package main
import (
"errors"
"fmt"
)
// 簡単な例：入力チェックで複数エラーを集める
func validateUser(name, email string) []error {
var errs []error
if name == "" {
errs = append(errs, errors.New("名前が未入力です"))
}
if email == "" {
errs = append(errs, errors.New("メールアドレスが未入力です"))
}
return errs
}
func main() {
// わざと空の値を渡してエラーを発生させる
errs := validateUser("", "")
if len(errs) > 0 {
fmt.Println("入力内容に問題があります：")
for _, err := range errs {
fmt.Println("-", err)
}
} else {
fmt.Println("入力に問題はありません")
}
}
このサンプルでは、名前とメールアドレスに対してそれぞれチェックを行い、問題があればerrsという変数にエラーをどんどん追加しています。最後に、エラーが一つでもあれば、まとめて画面に表示しています。ポイントは「どこかでエラーが出たらすぐに処理を中断する」のではなく、「最後までチェックして、見つかったエラーを全部集めてから報告する」という流れにしていることです。
このように、Go言語で複数エラーを扱う多重エラー処理を意識しておくと、ユーザーにとっても開発者にとってもわかりやすいエラーメッセージ設計ができるようになります。次の章からは、この考え方を実現する具体的な書き方やパターンを、実際のGoコードを使いながら詳しく見ていきます。
2. エラーとは？初心者にわかりやすく説明
ここで、エラーとは、プログラムの実行中に何か問題が起きたことを示す情報です。たとえば「ファイルが見つからない」「ネットワークに接続できない」などがエラーにあたります。
Go言語では、関数の戻り値としてエラー情報（error型）を返すことが多いです。このerrorは、問題があったかどうかを知らせる役割を持っています。
3. 複数のエラーをまとめる方法1：エラーのスライスを使う
最もシンプルな方法は、エラーをたくさん集めて、error型のスライス（リスト）に入れて返す方法です。
package main
import (
"errors"
"fmt"
)
// 複数の処理をしてエラーをスライスで返す例
func processAll() []error {
var errs []error
// 処理1でエラー発生
errs = append(errs, errors.New("処理1でエラー"))
// 処理2で問題なし
// 処理3でエラー発生
errs = append(errs, errors.New("処理3でエラー"))
return errs
}
func main() {
errors := processAll()
if len(errors) > 0 {
fmt.Println("複数のエラーが発生しました：")
for _, err := range errors {
fmt.Println("-", err)
}
} else {
fmt.Println("エラーはありませんでした")
}
}
このように複数のエラーを集めてまとめることで、あとからすべての問題をチェックできます。
4. 複数のエラーをまとめる方法2：カスタムエラー型を作る
もう少し便利に使いたい場合は、複数のエラーをまとめるための独自のエラー型（カスタムエラー型）を作る方法があります。これにより、エラーを一つの値として返しつつ、内部に複数のエラーを持たせられます。
package main
import (
"fmt"
"strings"
)
// 複数エラーをまとめるカスタムエラー型
type MultiError struct {
Errors []error
}
// errorインターフェースを満たすためのError()メソッド
func (m *MultiError) Error() string {
var messages []string
for _, err := range m.Errors {
messages = append(messages, err.Error())
}
return "複数エラー: " + strings.Join(messages, "; ")
}
func main() {
errs := &MultiError{}
errs.Errors = append(errs.Errors, fmt.Errorf("ファイルが見つかりません"))
errs.Errors = append(errs.Errors, fmt.Errorf("接続タイムアウト"))
if len(errs.Errors) > 0 {
fmt.Println(errs.Error())
}
}
この方法なら、MultiErrorを一つのエラーとして扱えますし、詳細なエラーも簡単に確認できます。
5. 複数エラー処理の便利なライブラリ
実務では、多重エラー処理をもっと簡単にするために、Goのコミュニティが作ったライブラリを使うことも多いです。
例えば、hashicorp/go-multierrorというライブラリは、複数のエラーを簡単にまとめて扱えます。
import (
"fmt"
"github.com/hashicorp/go-multierror"
)
func main() {
var result error
// 複数のエラーを追加
result = multierror.Append(result, fmt.Errorf("エラー1"))
result = multierror.Append(result, fmt.Errorf("エラー2"))
if result != nil {
fmt.Println(result)
}
}
このように、ライブラリを使うと複数エラーの扱いが楽になります。
6. 複数エラー処理で気をつけるポイント
- 複数のエラーが起きる場面を想定して、適切に情報をまとめることが大切です。
- エラーを無視せず、必ずログやユーザー通知などに活用しましょう。
- 単純に最初のエラーだけを返すのではなく、多重エラーとして扱うことで問題発見がしやすくなります。
- エラーをまとめるときは可読性を保つために、メッセージの区切り方や形式を工夫しましょう。
まとめ
Go言語における多重エラー処理（複数エラーのまとめ方）は、実践的な開発では非常に重要な考え方です。特に、ファイル処理・ネットワーク通信・複数の検証処理が重なるようなプログラムでは、一つの処理の中で複数のエラーが同時に発生することも珍しくありません。そのため、すべてのエラーを正確に把握しておくことは、後から問題の原因を追跡したり、ログに残したり、ユーザーに適切なメッセージを提示するうえで欠かせない作業になります。今回の記事で学んだように、複数エラーを扱うための方法はいくつかあり、スライスでまとめる基本的なやり方から、カスタムエラー型を定義して読みやすく整理された形式にする方法、そしてコミュニティが提供する便利なライブラリを用いる手法まで、段階的にレベルアップできる構成になっています。 特に、Go言語の特徴として「エラーを戻り値として返す」文化があり、例外処理が存在しない分、エラーの扱いについて細かい部分まで自分で制御する必要があります。そのため、多重エラー処理に慣れることで、日常的な開発の中でより安全で信頼できるコードを書くための基礎となります。また、複数のエラーが発生する可能性がある場面では、最初のエラーだけでなく、すべてを検出して返せるような仕組みを作ることで、より正確で丁寧なプログラム設計が可能になります。 さらに、スライスにエラーをまとめて返す方法は構造がシンプルであり、初心者でも取り入れやすい点が大きな魅力です。一方、カスタムエラー型を用いる方法は、複数のエラーを1つのエラーとして扱えるため、呼び出し側でのコードがすっきりし、エラー全体の読みやすさが格段に向上します。そして、go-multierrorのようなライブラリは、既に整備された仕組みを使えるため、実装の手間を減らしつつ堅牢な多重エラー処理を取り入れることができます。 こうした多重エラー処理の基礎を身につけておけば、API開発、ファイル操作、データ検証など、幅広い場面で応用でき、初心者から中級者へステップアップする大きなきっかけとなります。
サンプルプログラムで学びを深めよう
以下は、スライス・カスタム型・複数パターンを組み合わせた応用的な多重エラー処理の例です。この記事全体で解説してきた内容をまとめながら、複数エラーを扱う流れを復習できる構成になっています。
package main
import (
"errors"
"fmt"
"strings"
)
// カスタムの複数エラー型
type MultiError struct {
Errors []error
}
func (m *MultiError) Error() string {
var list []string
for _, err := range m.Errors {
list = append(list, err.Error())
}
return "複数の問題: " + strings.Join(list, " / ")
}
// いくつかのチェック処理を行う例
func validateData(name string, age int) error {
var multi MultiError
if name == "" {
multi.Errors = append(multi.Errors, errors.New("名前が入力されていません"))
}
if age < 0 {
multi.Errors = append(multi.Errors, errors.New("年齢がマイナスです"))
}
if age > 120 {
multi.Errors = append(multi.Errors, errors.New("年齢の値が不正です"))
}
if len(multi.Errors) > 0 {
return &multi
}
return nil
}
func main() {
err := validateData("", -5)
if err != nil {
fmt.Println("エラー一覧:", err)
} else {
fmt.Println("すべてのチェックに成功しました")
}
}
このサンプルでは複数の条件に応じてエラーが追加され、最後に一つのエラーとして返される仕組みになっています。実際の開発でも、複数項目を同時にチェックする場面は多く、この書き方は非常に役立ちます。特にフォーム入力や設定ファイルの検証では、ユーザーが修正すべき部分を明確に提示できるため、とても親切なエラーメッセージ設計になります。
生徒
「先生、今回の多重エラー処理は本当に勉強になりました！複数のエラーをまとめるって想像したより便利なんですね。」
先生
「その通りです。特にGo言語では、エラー処理を丁寧に書くことがプログラムの品質に直結します。まとめて扱えると、とても見通しがよくなりますよ。」
生徒
「スライスでまとめる方法と、カスタム型でまとめる方法では何が違うんですか？」
先生
「スライスはシンプルで扱いやすいですが、呼び出し側ではエラーの扱いが少し複雑になります。その点、カスタム型を使えばひとつのエラーとして扱えるので、コードがより読みやすくなりますね。」
生徒
「なるほど！ライブラリを使う方法もあるって知れて勉強になりました。実務ではそういう便利ツールも使っていくんですね。」
先生
「その通り。基本がわかっていれば、どの方法も適材適所で使い分けられます。今回覚えた内容は、実際の開発でもきっと役に立ちますよ。」
この記事を読んだ人からの質問
