先生と生徒の会話形式で理解しよう

生徒

「C#でテストを実行してみたのですが、真っ赤なバツ印が出て失敗してしまいました。どうすれば直せますか？」

先生

「テストが失敗するのは、プログラムが正しく動いているか確認できた証拠ですよ。焦らずに、なぜ失敗したのか原因を探るトラブルシューティングをしてみましょう。」

生徒

「トラブルシューティングって、具体的にどこをチェックすれば良いのでしょうか？」

先生

「エラーメッセージの読み方から、よくあるミスの見つけ方まで、基本から丁寧に解説していきますね！」

1. テスト失敗とトラブルシューティングの基本

C#のプログラミングにおいて、テスト（Unit Test）とは作成したプログラムが意図した通りに動くかを確認する作業です。テストが失敗したとき、その原因を突き止めて修正することをトラブルシューティングと呼びます。

パソコンを初めて触る方にとって、画面に赤い文字やエラーが表示されると怖く感じるかもしれません。しかし、テストの失敗は「ここが間違っているよ」というプログラムからの親切な教えてメッセージです。まずは落ち着いて、画面に表示されている情報を読み解くことから始めましょう。プログラミングの上達は、このトラブルシューティングの経験を積むことで加速します。

2. エラーメッセージとスタックトレースを確認する

テストが失敗すると、必ずエラーメッセージが表示されます。これは「何が起きたか」を説明する文章です。例えば、「期待していた値と実際の値が違います」といった内容が書かれています。

もう一つ重要なのがスタックトレースです。これは、プログラムのどの行で問題が発生したかを示す「住所」のようなものです。C#のテストツールでは、エラーが発生したファイル名と行番号が表示されるので、まずはその場所を特定しましょう。

例えば、足し算をするプログラムのテストが失敗した場合のコードを見てみましょう。


using Xunit;

public class MathBuilder
{
    public int Add(int a, int b)
    {
        // 本来は a + b だが、間違えて引き算にしている例
        return a - b; 
    }
}

public class MathTests
{
    [Fact]
    public void AddTest()
    {
        var math = new MathBuilder();
        int result = math.Add(5, 3);
        // 5 + 3 = 8 を期待しているが、実際は 2 になるため失敗する
        Assert.Equal(8, result);
    }
}

この場合、テスト結果には「Expected: 8, Actual: 2」といったメッセージが表示されます。これを見るだけで、計算ロジックに間違いがあることがすぐに分かります。

3. 期待値と実際の値を比較するアサーションの確認

テストコードの中には、Assert.Equalという命令がよく出てきます。これをアサーション（断定）と言います。アサーションは、「この結果はこうなるはずだ！」と宣言する役割を持っています。

トラブルシューティングの際は、以下の二点を疑ってみてください。

プログラム本体が間違っている： 計算式や条件分岐のロジックにミスがある。
テストコードが間違っている： 「期待する値（Expected）」の設定自体が間違っている。

実は、初心者のうちは「テストコード側の期待値」を書き間違えていることも多いのです。プログラムを直す前に、まずは自分が何を正しい結果だと思い込んでいるか再確認しましょう。

4. ヌル参照（NullReferenceException）のトラブルシューティング

C#のテストで最も頻繁に出会うエラーの一つがNullReferenceException（ヌル参照例外）です。これは、中身が空っぽの状態（null）のものに対して、何か操作をしようとしたときに発生します。

例えば、名前を保存する変数に何も入っていないのに、その文字数を数えようとするとエラーになります。簡単な例を見てみましょう。


public class User
{
    public string Name { get; set; }
}

public class UserTests
{
    [Fact]
    public void GetNameLengthTest()
    {
        User user = new User();
        // user.Name に何も入れていない（nullの状態）
        int length = user.Name.Length; 
        Assert.Equal(0, length);
    }
}

上記のコードを実行すると、user.Nameが空っぽなのでエラーで止まります。トラブルシューティングでは、変数の初期化（最初に値を入れること）を忘れていないか、データがどこかで消えていないかをチェックしましょう。

5. デバッグ機能を使ってプログラムを一時停止させる

原因がどうしても分からないときは、デバッグ（Debug）という機能を使います。これは、プログラムの動きをスロー再生したり、途中で一時停止させたりする魔法のような機能です。

ブレークポイントという目印をコードの行に付けると、プログラムがその場所で止まります。止まっている間は、その時の変数にどんな数字や文字が入っているかをマウスをかざすだけで確認できます。一行ずつプログラムを進める「ステップ実行」を使えば、どのタイミングで値がおかしくなったのかを確実に特定できます。

6. データの型と初期値の勘違いを防ぐ

C#には、整数を扱うint型や、文字を扱うstring型など、データの種類（型）があります。この型の特性を理解していないと、テストが失敗しやすくなります。

例えば、割り算の結果を整数型で受け取ると、小数点以下が切り捨てられてしまいます。これが原因でテストの計算結果が合わないことがよくあります。


public class Calculator
{
    public int Divide(int a, int b)
    {
        // 5 / 2 = 2.5 だが、int型なので 2 が返ってしまう
        return a / b;
    }
}

public class CalcTests
{
    [Fact]
    public void DivideTest()
    {
        var calc = new Calculator();
        int result = calc.Divide(5, 2);
        // 2.5を期待してテストを書くと失敗する
        Assert.Equal(2.5, (double)result); 
    }
}

数値の型が適切かどうか、また変数の初期値（指定しない場合に最初に入る値。intなら0など）が計算に悪影響を与えていないかを確認しましょう。

7. 外部要因と環境のトラブルシューティング

プログラム自体に間違いがなくても、テストが失敗することがあります。これは環境要因と呼ばれるものです。

ファイルパスの問題： 読み込もうとしているファイルが存在しない、または場所が違う。
データベースの接続： データを保存する場所への接続が切れている。
設定ファイル： appsettings.jsonなどの設定内容が間違っている。

テストが特定のパソコンでしか動かない、あるいは時々失敗するといった場合は、これらの外部環境を疑ってみてください。テストを実行する前に必要なファイルを準備する「セットアップ」の手順が抜けていないか確認することが大切です。

8. 条件分岐とループ処理の境界値をチェックする

テスト失敗の隠れた原因として多いのが、境界値（ボーダーライン）のミスです。例えば、「100点以上は合格」というプログラムを作る際、> 100（100より大きい）と書いてしまうと、ちょうど100点の人が不合格になってしまいます。

正しい書き方は>= 100（100以上）です。テストでは、こういったギリギリの数字で失敗することが多いため、条件式の不等号が正しいか、ループが回る回数が一回多くないか、あるいは少なくないかを重点的にチェックしましょう。


public class Judge
{
    public bool IsPass(int score)
    {
        // 60点以上で合格にしたいが、書き方を間違えている例
        if (score > 60) 
        {
            return true;
        }
        return false;
    }
}

public class JudgeTests
{
    [Fact]
    public void Score60Test()
    {
        var judge = new Judge();
        // 60点は合格のはずだが、上のロジックでは false が返り、テストが失敗する
        Assert.True(judge.IsPass(60));
    }
}

このように、境界値付近のテストデータを増やすことで、潜在的なバグを見つけやすくなります。

9. テストのログ出力を活用する

画面に何も表示されずにテストが失敗するときは、自分でメッセージを出力させる方法が有効です。Console.WriteLineなどを使って、プログラムがどこまで進んだか、その時の変数の値は何かを表示させてみましょう。

テストツールによっては、標準出力（プログラムのメッセージ）をテスト結果の詳細画面に表示してくれる機能があります。デバッガーを使うのが難しい環境や、複雑な流れを一度に把握したいときには、この「ログ出力による確認」が非常に強力な武器になります。迷ったら、まず怪しい場所の直前で値を表示させる癖をつけましょう。