2025/06/01 04:54 Structured Errors in Go
やあ、ロボ子。今日のITニュースはGoのエラー処理についてじゃ。
博士、こんにちは。Goのエラー処理ですか。なんだか難しそうですね。
難しくないぞ！Goのエラー処理は、他の言語の例外処理と違って、シンプルな戻り値アプローチを採用しておる。基本はテキスト文字列なんじゃ。
テキスト文字列が基本、ですか。でも、それだけだと情報が少なすぎませんか？
そう思うじゃろ？そこで構造化ロギングが重要になるんじゃ。エラーが発生した時に、コンテキストを追加することで、問題の診断に役立つんじゃよ。
コンテキストを追加、ですか。具体的にはどうすれば？
例えば、HTTPサーバーのエラー処理なら、エラーが発生した時にログに記録するじゃろ？そのログに、アカウントIDとか、タイムスタンプとか、関連する情報を構造化して含めるんじゃ。
なるほど。構造化されていないログだと、特定のアカウントでフィルタリングするのが難しい、と。
その通り！それに、使いにくいツールは利用されにくいからの。Goのエラー処理は比較的エルゴノミックじゃが、カスタムエラー型は作成に手間がかかる。だから、エラー処理のすべてのインスタンスで特定の処理を行うようにして、チーム全体で一貫性を保つことが大切なんじゃ。
エラーにメタデータを付加して、ログ記録やクライアントへの応答時に簡単にアクセスできるようにするんですね。
そうじゃ！Goのcontextライブラリを使うと、コールツリー全体で情報を伝搬させることができる。コンテキストに格納されたメタデータをエラーに渡せば、コールツリーを遡って利用できるんじゃ。
コンテキストはコールツリーを下る際に情報を蓄積し、エラーはコールツリーを上る際に情報を蓄積する、ですか。面白いですね。
じゃろ？実装例としては、コンテキストキー、メタデータを追加するヘルパー、取得するヘルパーが必要になるぞ。エラーをラップして、コンテキストのメタデータハッシュテーブルをエラーに格納するんじゃ。
`errors.Unwrap(err)`を繰り返し呼び出してエラーツリーを反復処理するんですね。
その通り！ただし、PII（個人情報）をコンテキスト、エラー、ログに含めないように注意するんじゃぞ。メタデータには、匿名の一意の識別子、関連するタイムスタンプ、slugを含めることができる。
命名規則を確立して、一貫性を保つことも重要ですね。
そういうことじゃ。便利なツールとして、`fctx`ユーティリティがあるぞ。Faultラッパーインターフェースと`Wrap(error, stuff...)`パターンを満たしておる。
勉強になります、博士！
ところでロボ子、エラー処理が完璧なプログラムって、どんなプログラムだと思う？
えっと…エラーが全く発生しないプログラム、でしょうか？
ブー！残念！正解は「エラーが発生しても、誰も気づかないプログラム」じゃ！
⚠️この記事は生成AIによるコンテンツを含み、ハルシネーションの可能性があります。