AspNetCoreDiagnosticScenarios
This repository has examples of broken patterns in ASP.NET Core applications
A reference collection of real broken code patterns found in ASP.NET Core web applications, with explanations of why each pattern fails and how to fix it. Focuses especially on async programming mistakes that only show up under load.
This repository is a reference collection of broken and problematic code patterns found in real ASP.NET Core applications. ASP.NET Core is a framework developers use to build web servers and web APIs with the C# programming language. The goal here is not to build a working product, but to document mistakes that show up repeatedly in production codebases and explain how to fix them.
The content comes from real incidents: issues customers encountered, problems surfaced on GitHub discussions, and questions from Stack Overflow. Rather than being a generic tutorial, it reflects the kinds of bugs and performance problems that actual teams ran into while building services that need to handle many users at once.
The repository contains two main guides. One covers general ASP.NET Core patterns and what goes wrong with them. The other focuses on asynchronous programming, which is a common source of subtle bugs where code appears to work correctly in simple tests but fails or slows down under load. Both guides are written to help developers understand not just what to avoid, but why the problematic patterns cause trouble.
The README is short and the real content lives in the linked guide files rather than the main page. If you are a developer working with ASP.NET Core, this is a practical reference rather than a beginner introduction.
Where it fits
- Review your ASP.NET Core codebase against documented anti-patterns to find async bugs that only appear under heavy traffic.
- Use as a code review checklist when auditing a C# web service for correctness and performance.
- Learn why specific patterns cause deadlocks or slowdowns in production by reading real incident-sourced examples.