導入
Go言語で開発を行っていると、パッケージレベルで変数を定義し、初期化を行うことはよくあります。しかし、複数のグローバル変数間で依存関係がある場合、初期化順序を誤ると予期せぬ挙動や実行時のパニックを招く恐れがあります。本記事では、Go言語におけるグローバル変数の初期化ルールを整理し、安全に設計するためのポイントを解説します。
基礎知識
Goのパッケージレベルの変数は、プログラムの起動時、`main`関数が実行される前に初期化されます。この初期化は「依存関係」に基づいて自動的に決定されます。具体的には、ある変数が他の変数の値を参照している場合、参照先の変数が先に初期化されます。もし依存関係がない場合は、ソースコード内に記述された順序に従って初期化が行われます。内部的には、コンパイラが各変数の依存関係をグラフとして解析し、トポロジカルソートを行うことで実行順序を決定しています。
実装/解決策
安全な設計のための鉄則は、「グローバル変数の依存関係を可能な限り排除すること」です。依存関係が複雑になると、コードの可読性が下がるだけでなく、意図しないタイミングで未初期化のデータにアクセスしてしまうリスクが高まります。依存関係が避けられない場合は、初期化関数 `init()` を活用するか、パッケージスコープの変数を減らし、依存注入（DI）のパターンを採用することを推奨します。
サンプルプログラム
以下のコードは、依存関係があるグローバル変数の初期化順序を示したものです。
package main
import “fmt”
// 変数Bは変数Aに依存している
var (
// Aが先に初期化される
A = 100
// Bの初期化にはAの値が必要
B = A + 50
)
// init関数はパッケージの初期化時に実行される
func init() {
fmt.Println(“初期化完了: A =”, A, “, B =”, B)
}
func main() {
// AとBは既に初期化済みであり、安全に使用できる
fmt.Printf(“メイン処理実行: A=%d, B=%d\n”, A, B)
}
応用・注意点
現場で陥りやすいバグとして、複数のファイルにまたがるグローバル変数の依存関係が挙げられます。`go build` 時のファイルリスト順によって初期化順序が変わるような設計は極めて危険です。
注意点:
1. 複雑な依存は避ける: グローバル変数同士が相互に依存するような設計（循環参照）は、コンパイルエラーになるか、あるいは初期化時にゼロ値が評価される原因となります。
2. init関数の乱用禁止: `init()` 関数は便利ですが、副作用が隠蔽されやすく、テストが困難になります。可能な限り、構造体のコンストラクタ（`New`関数など）で明示的に初期化を行う設計を目指しましょう。
3. 定数の活用: 変化しない値であれば、`var` ではなく `const` を使用してください。`const` はコンパイル時に確定するため、実行時の初期化順序問題を回避できます。
実務においては、これらの知識をベースに「依存関係を極小化する」設計を心がけることが、堅牢なバックエンドを構築する鍵となります。
コメント