C#を用いた開発において、LINQ(Language Integrated Query)は非常に便利なツールとして広く利用されています。

しかし、開発を進める中でSystem.InvalidOperationException: Sequence contains more than one matching elementというエラーに遭遇することがあります。

このエラーは、特定の条件でデータを抽出する際に、システムが想定している「一意性」が崩れたときに発生します。

エラーメッセージを直訳すると「シーケンスに一致する要素が複数含まれています」という意味になります。

本記事では、この例外が発生する具体的な原因とその対策、そして例外を防ぐためのコーディング規約について詳しく解説します。

目次 [ close ]
  1. エラーが発生する主な原因
  2. SingleメソッドとSingleOrDefaultメソッドの挙動
    1. 例外が発生するコードの例
  3. 例外を解決するための3つのアプローチ
    1. 1. FirstまたはFirstOrDefaultメソッドへの変更
    2. 2. データ側のクレンジングと制約の追加
    3. 3. フィルタリング条件の厳格化
  4. 実装時に検討すべき例外ハンドリング
  5. Singleを使うべき場面とFirstを使うべき場面の使い分け
  6. まとめ

エラーが発生する主な原因

この例外は、主にLINQのSingleメソッド、またはSingleOrDefaultメソッドを使用している際に発生します。

これらのメソッドは、コレクションの中から「条件に一致する要素がただ一つだけ存在する」ことを前提として設計されています。

プログラムのロジック上で、IDや一意のキーを使用してデータを取得する場合にこれらのメソッドがよく使われます。

しかし、データベース内のデータが重複していたり、フィルタリングの条件が不適切であったりすると、複数の要素がヒットしてしまいます。

その結果、実行環境は「どの要素を返すべきか判断できない」状態に陥り、この例外をスローします。

つまり、このエラーはデータの整合性に問題があるか、検索ロジックが不十分であることを示唆しています。

SingleメソッドとSingleOrDefaultメソッドの挙動

まずは、例外を発生させる原因となるメソッドの仕様を正しく理解することが重要です。

以下の表は、各メソッドが要素数に応じてどのような挙動を示すかをまとめたものです。

メソッド名一致する要素が0個の場合一致する要素が1個の場合一致する要素が2個以上の場合
Single()例外発生要素を返す例外発生
SingleOrDefault()既定値(null等)を返す要素を返す例外発生

表から分かる通り、SingleOrDefaultを使用しても、要素が2個以上存在する場合には例外を回避することはできません。

OrDefaultという名称は、あくまで「0個の場合」に対する処理を指している点に注意してください。

例外が発生するコードの例

具体的にどのようなコードで例外が発生するのか、簡単なサンプルを見てみましょう。

C#
using System;
using System.Collections.Generic;
using System.Linq;

public class Program
{
    public static void Main()
    {
        var users = new List<User>
        {
            new User { Id = 1, Name = "田中" },
            new User { Id = 2, Name = "鈴木" },
            new User { Id = 2, Name = "佐藤" } // IDが重複している
        };

        try
        {
            // IDが2のユーザーを取得しようとする
            var user = users.Single(u => u.Id == 2);
            Console.WriteLine(user.Name);
        }
        catch (InvalidOperationException ex)
        {
            Console.WriteLine($"エラー発生: {ex.Message}");
        }
    }
}

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}
実行結果
エラー発生: Sequence contains more than one matching element

この例では、本来一意であるべきIdが重複しているため、Singleメソッドが例外をスローしています。

例外を解決するための3つのアプローチ

このエラーを解消するためには、プログラムの目的に応じて適切な修正を行う必要があります。

1. FirstまたはFirstOrDefaultメソッドへの変更

「複数存在する場合でも、その中の最初の1つを取得すれば良い」という仕様であれば、FirstまたはFirstOrDefaultに変更するのが最も簡単です。

これらのメソッドは、たとえ要素が100個一致しても、最初に見つかった1つだけを返し、残りは無視します。

C#
// 最初に見つかった要素を取得する（複数あってもエラーにならない）
var user = users.FirstOrDefault(u => u.Id == 2);

ただし、ビジネスロジック的に「本来は1つしかないはず」という場合には、この修正は根本的な解決にならない可能性があるため注意が必要です。

2. データ側のクレンジングと制約の追加

プログラムではなく、入力データやデータベース側に問題がある場合は、データの整合性を修正すべきです。

データベースのテーブル設計において、対象の列にユニーク制約(UNIQUE constraint)を設定することを検討してください。

ユニーク制約を設定することで、アプリケーション層に不正なデータが入り込むのを未然に防ぐことができます。

システム運用中にこのエラーが発生した場合は、まずSQLなどで対象のデータが重複していないかを調査することが先決です。

3. フィルタリング条件の厳格化

検索条件が広すぎるために、意図しない要素までヒットしている可能性があります。

Where句の条件を増やし、対象を確実に1つに絞り込めるようにロジックを見直してください。

C#
// 複数の条件を組み合わせて一意に特定する
var item = products.SingleOrDefault(p => p.Category == "Electronics" && p.Code == "A-100");

実装時に検討すべき例外ハンドリング

プログラムが予期せぬデータを受け取る可能性がある場合、例外が発生することを前提とした実装も検討すべきです。

例えば、Anyメソッドを使用して、事前に要素が複数存在しないかチェックする手法があります。

C#
var matchingCount = users.Count(u => u.Id == 2);

if (matchingCount > 1)
{
    // ログ出力やカスタムエラー処理を行う
    Console.WriteLine("データが重複しています。管理者に連絡してください。");
}
else
{
    var user = users.SingleOrDefault(u => u.Id == 2);
    // 正常処理
}

このように、例外が発生してから対処するのではなく、事前チェックを行うことで、ユーザー体験を損なわない設計が可能になります。

Singleを使うべき場面とFirstを使うべき場面の使い分け

開発現場では、「常にFirstOrDefaultを使えばエラーが出なくて安全だ」という意見もあります。

しかし、安易にFirstOrDefaultを使うことが常に正解とは限りません。

「データが1つであること」がシステムの動作保証において必須条件であるなら、あえてSingleを使うべきです。

なぜなら、Singleを使ってエラーを出すことで、「本来あり得ない異常事態」を早期に検知できるからです。

もしFirstOrDefaultでエラーを隠蔽してしまうと、不正なデータに基づいた計算がそのまま進み、後に大きな不具合を招く恐れがあります。

「エラーが出るのが怖いから避ける」のではなく、「エラーが出るべき場所で正しくエラーを出す」ことが、堅牢なシステム構築の鍵となります。

まとめ

System.InvalidOperationException: Sequence contains more than one matching elementは、開発者にデータの不整合を知らせてくれる重要なサインです。

このエラーに遭遇した際は、まず「データが一意であるべきか、そうでないか」を再確認してください。

もし一意であるべきなら、データベースの制約やデータ入力フローを見直しましょう。

もし複数存在する可能性があるなら、FirstやFirstOrDefault、あるいはWhereによるリスト取得へと実装を変更してください。

LINQメソッドの特性を正しく理解し使い分けることで、よりデバッグしやすく信頼性の高いC#プログラムを書くことができるようになります。

この記事が、エラーの解決と今後のコーディングの参考になれば幸いです。