6.5 スタックトレース

6.5.1 スタックトレースの出し方

Go 1.24では標準ライブラリであるerrors.New()やfmt.Errorf()を使ってエラーを生成した場合、スタックトレースを出力する方法はありません。スタックトレースを出力させたい場合golang.org/x/xerrorsやgithub.com/cockroachdb/errorsといったライブラリを使う必要があります。下記にgolang.org/x/xerrorsをインポートして使用する例を紹介します。

リスト6-12: xerrorsを利用するコード
import (
	"fmt"

	"golang.org/x/xerrors"
)

func main() {
	err := xerrors.New("xerrors error")
	fmt.Printf("%+v\n", err)
}
リスト6-13: 実行例
     $ go run .
     xerrors error:
             main.main
                     /tmp/sandbox2141067495/main.go:10

実は標準ライブラリにGo 1.13から組み込まれたerrors.Is()、errors.As()、errors.Unwarp()は、xerrorsパッケージの実装から組み込まれたものです。標準ライブラリに機能が移植されたためxerrors.As()、xerrors.Is()、xerrors.Unwap()は非推奨になっています。

かつてはgithub.com/pkg/errorsがよく利用されていましたが、2025/10現在リポジトリはアーカイブされています。

github.com/pkg/errorsの代替として作られた ...