はじめに
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を発信していきます。
よければストック・フォローお願いします!