0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【C#】Entity Framework Coreでハマりやすい落とし穴と対処法【初心者向け】

0
Posted at

はじめに

Entity Framework Core(EF Core)は便利なORMですが、正しく理解していないとパフォーマンス低下や意図しない動作を引き起こします。
この記事では、実務でよく遭遇する「落とし穴」とその対処法をわかりやすく解説します。


1. 遅延読み込み(Lazy Loading)によるN+1問題

❌ よくあるミス

関連データをループ内で参照してしまい、SQLが大量に発行される。

var orders = context.Orders.ToList();

foreach (var order in orders)
{
    Console.WriteLine(order.Customer.Name); // 毎回SQLが発行される
}

なぜ問題?

  • ループ回数分 SQL が発行され、パフォーマンスが大幅に低下する

✅ 正しい書き方(Eager Loading)

var orders = context.Orders
    .Include(o => o.Customer)
    .ToList();

foreach (var order in orders)
{
    Console.WriteLine(order.Customer.Name); // SQLは1回だけ
}

2. トラッキング(Tracking)が不要なのに有効のまま

❌ よくあるミス

読み取り専用のクエリでもトラッキングが有効になっている。

var users = context.Users.ToList(); // Tracking ON

なぜ問題?

  • メモリ使用量が増える
  • 不要な変更検知が走る

✅ 正しい書き方(AsNoTracking)

var users = context.Users
    .AsNoTracking()
    .ToList();

3. マイグレーションの衝突・不整合

❌ よくあるミス

複数人で開発していると、マイグレーションが衝突してビルドエラーになる。

The model snapshot was not found.

なぜ起きる?

  • Snapshot が古い
  • マイグレーションファイルの順序が崩れる

✅ 対処法

  • 最新のマイグレーションを pull してから追加する
  • 不要なマイグレーションを削除して再生成する
  • 最終手段として Remove-Migration → Add-Migration で再作成

4. SaveChanges() をループ内で呼んでしまう

❌ よくあるミス

foreach (var item in items)
{
    context.Add(item);
    context.SaveChanges(); // 毎回DBアクセス
}

なぜ問題?

  • パフォーマンスが極端に悪くなる
  • トランザクションが細切れになる

✅ 正しい書き方

foreach (var item in items)
{
    context.Add(item);
}

context.SaveChanges(); // まとめて1回

5. Include の使いすぎで巨大クエリになる

❌ よくあるミス

var data = context.Orders
    .Include(o => o.Customer)
    .Include(o => o.Items)
    .Include(o => o.Payments)
    .Include(o => o.Shipping)
    .ToList();

なぜ問題?

  • JOIN が増えすぎてクエリが重くなる
  • 不必要なデータまで取得してしまう

✅ 正しい書き方

  • 必要なデータだけを取得する
  • 分割して取得する(Split Query)
var orders = context.Orders
    .Include(o => o.Customer)
    .AsSplitQuery()
    .ToList();

実務でのベストプラクティスまとめ

  • Include は必要最小限にする
  • 読み取り専用は AsNoTracking()
  • SaveChanges() は まとめて1回
  • Lazy Loading は基本 OFF(N+1対策)
  • マイグレーションはチームでルールを統一する

まとめ

  • EF Core は便利だが、誤用するとパフォーマンス低下やバグの原因になる
  • 特に「N+1問題」「Tracking」「SaveChangesの乱発」は要注意
  • ベストプラクティスを守ることで、安全で高速なデータアクセスが実現できる

おわりに

今後も C# / .NET / Azure の実務で役立つTipsを発信していきます。
よければストック・フォローお願いします!

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?