Go言語でエラー出力(Print Error)の使い方を解説

type error interface {
    Error() string
}

package main
import (
	"fmt"
)
// MyErrorは独自のエラー型です。
type MyError struct {
	Message string
}
// ErrorはMyErrorのエラーメッセージを返します。
func (e *MyError) Error() string {
	return fmt.Sprintf("Error: %s", e.Message)
}
func main() {
	// エラー変数にMyErrorのインスタンスを代入
	var err error = &MyError{Message: "サンプルエラーです"}
	// エラーメッセージを出力します
	fmt.Println(err.Error())
}

Error: サンプルエラーです

package main
import (
	"errors"
	"fmt"
)
// doSomethingはエラーが発生する可能性のある処理です。
func doSomething(flag bool) error {
	if flag {
		// エラー生成：flagがtrueの場合にエラーを返します。
		return errors.New("処理中にエラーが発生しました")
	}
	// エラーがなければnilを返します。
	return nil
}
func main() {
	// エラーが発生するケースを例示します。
	err := doSomething(true)
	if err != nil {
		// エラー発生時にエラーメッセージを出力します。
		fmt.Println("エラー:", err)
	} else {
		fmt.Println("正常に処理が完了しました")
	}
}

エラー: 処理中にエラーが発生しました

package main
import (
	"errors"
	"fmt"
)
func main() {
	// errors.Newでエラーを生成
	err := errors.New("シンプルなエラーです")
	// fmt.Printlnでエラーメッセージをそのまま出力します
	fmt.Println(err)
}

シンプルなエラーです

package main
import (
	"fmt"
)
func main() {
	// 変数情報を組み込んだエラーメッセージを生成します。
	userName := "Alice"
	err := fmt.Errorf("ユーザ %s の認証に失敗しました", userName)
	// エラーメッセージを出力します
	fmt.Println(err)
}

ユーザ Alice の認証に失敗しました

package main
import (
	"errors"
	"log"
)
func main() {
	// サンプルエラーを生成
	err := errors.New("ログ出力のサンプルエラーです")
	// エラーメッセージをログに記録し、処理を続行する例
	log.Print("エラー発生:", err)
	// 以下の行は、log.Fatalが呼ばれると実行されません。
	log.Fatal("致命的なエラー:", err)
	// この行は実行されません
	// fmt.Println("プログラム終了")
}

2023/10/05 12:00:00 エラー発生: ログ出力のサンプルエラーです
2023/10/05 12:00:00 致命的なエラー: ログ出力のサンプルエラーです

package main
import (
	"fmt"
)
// CustomErrorは独自のエラー情報を保持する構造体です。
type CustomError struct {
	Message string  // エラーメッセージ
	Code    int     // エラーコード
}
// ErrorはCustomErrorのエラーメッセージを返します。
func (e *CustomError) Error() string {
	return fmt.Sprintf("エラー: %s [コード: %d]", e.Message, e.Code)
}
func main() {
	// CustomErrorのインスタンスを作成しエラーとして返します。
	err := &CustomError{Message: "予期せぬ動作", Code: 404}
	fmt.Println(err.Error())
}

エラー: 予期せぬ動作 [コード: 404]

package main
import (
	"fmt"
)
// NetworkErrorは通信関連のエラーです。
type NetworkError struct {
	Msg string
}
// ErrorはNetworkErrorのエラーメッセージを返します。
func (e *NetworkError) Error() string {
	return fmt.Sprintf("ネットワークエラー: %s", e.Msg)
}
// IOErrorは入出力関連のエラーです。
type IOError struct {
	Msg string
}
// ErrorはIOErrorのエラーメッセージを返します。
func (e *IOError) Error() string {
	return fmt.Sprintf("IOエラー: %s", e.Msg)
}
func main() {
	// サンプルとしてNetworkErrorを発生させます。
	err := generateError(true)
	// 型スイッチを利用してエラーの種類を判定します。
	switch e := err.(type) {
	case *NetworkError:
		fmt.Println("ネットワークエラーの処理:", e.Msg)
	case *IOError:
		fmt.Println("IOエラーの処理:", e.Msg)
	default:
		fmt.Println("その他のエラー:", err)
	}
}
// generateErrorは条件に応じて異なるエラーを返します。
func generateError(flag bool) error {
	if flag {
		return &NetworkError{Msg: "接続タイムアウト"}
	}
	return &IOError{Msg: "ファイルが見つかりません"}
}

ネットワークエラーの処理: 接続タイムアウト

package main
import (
	"errors"
	"fmt"
)
// 事前にエラーインスタンスを定義
var (
	ErrNetwork = errors.New("ネットワークエラー")
	ErrIO      = errors.New("IOエラー")
)
// processErrorはエラー種類に応じた処理を行います。
func processError(err error) {
	if err != nil {
		// エラーインスタンスの比較による判定
		if err == ErrNetwork {
			fmt.Println("処理：ネットワークエラー発生")
		} else if err == ErrIO {
			fmt.Println("処理：IOエラー発生")
		} else {
			fmt.Println("処理：その他のエラー", err)
		}
	} else {
		fmt.Println("エラーは発生していません")
	}
}
func main() {
	// 複数のエラーケースをテスト
	processError(ErrNetwork)
	processError(nil)
	processError(ErrIO)
}

処理：ネットワークエラー発生
エラーは発生していません
処理：IOエラー発生

package main
import (
	"fmt"
)
// DownloadErrorはダウンロード時のエラーを表します。
type DownloadError struct {
	StatusCode int
}
// ErrorはDownloadErrorのエラーメッセージを返します。
func (e *DownloadError) Error() string {
	return fmt.Sprintf("ダウンロードエラー [ステータスコード: %d]", e.StatusCode)
}
// SaveErrorはファイル保存時のエラーを表します。
type SaveError struct {
	Filename string
	Reason   string
}
// ErrorはSaveErrorのエラーメッセージを返します。
func (e *SaveError) Error() string {
	return fmt.Sprintf("保存エラー: %s (ファイル: %s)", e.Reason, e.Filename)
}
func main() {
	// サンプルエラーを生成
	var err error = simulateError("download")
	handleError(err)
	err = simulateError("save")
	handleError(err)
}
// simulateErrorは指定された種類のエラーを返します。
func simulateError(errorType string) error {
	if errorType == "download" {
		return &DownloadError{StatusCode: 500}
	} else if errorType == "save" {
		return &SaveError{Filename: "output.txt", Reason: "ディスクスペース不足"}
	}
	return nil
}
// handleErrorはエラーの種類に応じた処理を行います。
func handleError(err error) {
	if err != nil {
		// 型スイッチでエラーを判別
		switch e := err.(type) {
		case *DownloadError:
			fmt.Println("ダウンロードエラー処理:", e.Error())
		case *SaveError:
			fmt.Println("保存エラー処理:", e.Error())
		default:
			fmt.Println("その他のエラー処理:", err.Error())
		}
	} else {
		fmt.Println("エラーはありません")
	}
}

ダウンロードエラー処理: ダウンロードエラー [ステータスコード: 500]
保存エラー処理: 保存エラー: ディスクスペース不足 (ファイル: output.txt)