Go言語のインターフェースを活用したテストの書き方

1. インターフェースを使ったテストの基本

1. インターフェースを使ったテストの基本

Go言語では、関数や構造体が特定のインターフェースを満たしていれば、そのインターフェース型として扱えます。これにより、テスト用に簡単なモックを用意することができます。

type Printer interface {
    Print(message string)
}

type ConsolePrinter struct{}

func (c ConsolePrinter) Print(message string) {
    fmt.Println(message)
}

この例では Printer インターフェースを定義し、ConsolePrinter がその実装をしています。テストでは ConsolePrinter の代わりにモックを使えます。

2. モックを使ったテストの例

2. モックを使ったテストの例

モックを作ることで、実際に標準出力に出力せずに、関数が正しく呼ばれたかどうかを確認できます。

type MockPrinter struct {
    Messages []string
}

func (m *MockPrinter) Print(message string) {
    m.Messages = append(m.Messages, message)
}

func TestPrint(t *testing.T) {
    mock := &MockPrinter{}
    mock.Print("Hello")
    if len(mock.Messages) != 1 || mock.Messages[0] != "Hello" {
        t.Errorf("期待したメッセージが出力されませんでした")
    }
}

ここでは MockPrinter を作り、Print が正しく呼ばれたか確認しています。モックを使うことで、出力先に依存せずにテストができます。

3. インターフェースで依存性を減らす

3. インターフェースで依存性を減らす

インターフェースを使うことで、関数や構造体が具体的な実装に依存しなくなります。これを「依存性の注入」と呼びます。依存性を減らすと、テストが簡単になります。

func SendMessage(p Printer, msg string) {
    p.Print(msg)
}

func main() {
    cp := ConsolePrinter{}
    SendMessage(cp, "こんにちは")
}

関数 SendMessage は Printer 型の引数を受け取ります。実際の出力やテスト用のモックを自由に入れ替えられます。

4. テストを安全に書くポイント

4. テストを安全に書くポイント

• インターフェース型を使って、実際の処理とテスト用の処理を分ける
• モックを作ることで、外部依存（ファイル、ネットワークなど）を避ける
• 関数や構造体の依存性を減らすことでテストが容易になる
• 標準の testing パッケージを活用して、自動でテストを実行する

5. 実践的な活用例

5. 実践的な活用例

例えば、ユーザー情報を保存する処理をテストしたいとき、データベースに依存せずモックを使えば、テストは高速で安全に行えます。

type UserStore interface {
    Save(user string) error
}

type MockUserStore struct {
    Saved []string
}

func (m *MockUserStore) Save(user string) error {
    m.Saved = append(m.Saved, user)
    return nil
}

func TestSaveUser(t *testing.T) {
    store := &MockUserStore{}
    store.Save("Alice")
    if len(store.Saved) != 1 || store.Saved[0] != "Alice" {
        t.Errorf("ユーザー保存が正しく行われませんでした")
    }
}

このように、インターフェースを使うことで簡単にテスト可能なコードを書けます。実際のデータベースや外部サービスを使わなくても、モックでテストできるのがポイントです。

まとめ

まとめ

今回の記事では、Go言語のインターフェースがテストにおいてどれほど重要で役立つ存在なのかを丁寧に整理して学びました。単に「インターフェースを使うと便利」という表面的な理解にとどまらず、なぜテストを容易にし、どうして現場で頻繁に使われるのかといった背景まで知ることができたはずです。特に、Go の特徴でもある「実装側が明示的に宣言しなくても、メソッドを持っていればインターフェースを満たす」という仕組みは、テストコードの自由度を大きく高めてくれる点として印象に残ったのではないでしょうか。

実務では、外部サービス、ネットワーク通信、ファイル操作、データベースアクセスなど、テストが難しく感じる処理が多く登場します。そのような処理をすべて本物の環境で実行していたら、テストは遅くなり、不安定になり、場合によっては実行すらできません。そこで活用できるのがインターフェースとモックです。インターフェースを挟み込むことで、関数や構造体は「実際の処理とは切り離された抽象的な動作（メソッド）」だけを見て動くようになり、テスト時はその動作だけを満たしたモックを差し替えるだけでよくなります。

この仕組みは、開発を効率化するだけでなく、アプリケーションの安全性や信頼性を高める上でも欠かせません。モックは「意図した動作のみを行う」ため、テスト結果の再現性が非常に高くなり、いつ実行しても安定した結果を得られます。初学者にとっては「モックって難しそう」と感じることもありますが、実際には構造体にメソッドを追加するだけで簡単に作れるため、一度慣れてしまえばどんどん使いこなせるようになります。

■ テスト用モックは「差し替えできる部品」

例えば、ユーザーへメッセージを送る処理を考えてみましょう。実際のアプリではメールやチャットシステムに依存するため、テストがしにくい場面です。このような時こそインターフェースを使います。

type Notifier interface {
    Notify(msg string) error
}

type EmailNotifier struct{}

func (e EmailNotifier) Notify(msg string) error {
    fmt.Println("メール送信:", msg)
    return nil
}

// テスト用モック
type MockNotifier struct {
    Logs []string
}

func (m *MockNotifier) Notify(msg string) error {
    m.Logs = append(m.Logs, msg)
    return nil
}

func Send(n Notifier, msg string) error {
    return n.Notify(msg)
}

このように設計しておくと、実際のメール送信を行わずに次のようなテストが書けます。

func TestSend(t *testing.T) {
    mock := &MockNotifier{}
    Send(mock, "こんにちは")

    if len(mock.Logs) != 1 || mock.Logs[0] != "こんにちは" {
        t.Errorf("通知処理が正しく行われませんでした")
    }
}

このテストは外部環境に左右されず、通知が確実に呼び出されたかどうかだけを確認できます。依存を取り除くことで、コードのテストが驚くほど簡単になり、保守しやすい状態へと近づきます。

■ インターフェースを使った設計は拡張に強い

インターフェースを使うメリットはテストだけではありません。通知方法をメール以外に追加したい場合、Slack 通知や LINE 通知などを新しい構造体として追加し、同じ Notify メソッドを実装するだけで機能を簡単に広げられます。既存の Send 関数をいじらずに機能追加できるため、バグが入り込むリスクも減ります。

実務でもよく使われる「依存性注入」の考え方は、このインターフェースの柔軟性を最大限に活かした方法です。テスト、機能追加、保守性などあらゆる点でメリットがあります。

先生と生徒の振り返り会話