.NET & C# Errors
NuGet restore, null references, EF Core migrations, async deadlocks and Blazor interop.
Understanding C# errors
C# errors divide into compile-time and restore-time problems (NuGet resolution, target framework mismatches) and runtime problems dominated by null references and async misuse. The classic .NET production hazard is the sync-over-async deadlock, calling .Result or .Wait() on a task in a context with a synchronisation context, which manifests as a hang rather than an exception and is therefore much harder to spot.
How to debug C# errors
- Run
dotnet restore --verbosity detailedto see which feed each package resolved from. Most restore failures are a private feed with expired credentials, not a missing package. - Enable nullable reference types (
<Nullable>enable</Nullable>) and treat the warnings as errors. This converts a whole class of production NullReferenceExceptions into compile failures. - For async hangs, search the codebase for
.Result,.Wait()and.GetAwaiter().GetResult(). Replace withawaitall the way up, or useConfigureAwait(false)in library code. - For EF Core, run
dotnet ef migrations listto see which migrations the database believes are applied before generating a new one. - Capture a dump with
dotnet-dumpand inspect it withdotnet-gcdump/dotnet-counterswhen the process misbehaves without throwing.
Tools worth reaching for
dotnet restore -v detaileddotnet ef migrations listdotnet-countersdotnet-dump
All 12 C# errors
- .NET: NuGet restore failedNuGet package restore failed. Network issues, invalid package source, or missing credentials.
- .NET: The framework 'Microsoft.NETCore.App', version '8.0.0' was not found NewThe published application is framework dependent and the machine has no matching runtime. Roll forward will pick a…
- ASP.NET Core: Unable to resolve service for type while activating NewThe container was asked for a dependency nobody registered, so the controller or hosted service could not be…
- ASP.NET: Connection string not found in configurationThe application cannot find the database connection string in appsettings.json or environment variables.
- Blazor: JavaScript interop call failedA Blazor JS interop call threw an error because the JavaScript function was not found, threw an exception, or was…
- C#: CS8618 non-nullable property must contain a non-null value when exiting constructor NewWith nullable reference types enabled, the compiler requires every non-nullable member to be definitely assigned by…
- C#: Deadlock in async/awaitCalling .Result or .Wait() on an async method from a synchronisation context (UI thread, ASP.NET) causes a deadlock…
- C#: NullReferenceExceptionAttempting to access a member on a type that is null.
- EF Core: another instance with the same key value is already being tracked NewThe change tracker already holds an entity with that primary key and Attach or Update tried to add a second copy. It…
- EF Core: Update-Database not recognizedEF Core tools not installed or path issue. PowerShell command not found.
- StackOverflowExceptionInfinite recursion or very deep call stack exceeded the stack size. Unlike most exceptions, StackOverflowException…
- TaskCanceledExceptionAn async operation was cancelled via a CancellationToken or the HttpClient request timed out.
Other categories
- AI 35Rate limits, context windows, GPU memory and model-serving failures.
- Ansible 10Unreachable hosts, become passwords, undefined variables and Jinja2 failures.
- API 14Auth headers, payload limits, versioning, idempotency and webhook signatures.
- Apple 10Command line tools, dyld, Homebrew permissions, notarisation and Keychain.
- Auth 11OIDC, SAML, Auth0, Okta, Keycloak, passkeys and MFA failures.
- BigData 11Spark, Kafka, Airflow, Snowflake, Flink and Databricks failures.
- C++ 11Segfaults, linker errors, memory corruption and template deduction failures.
- Caching 10Cache stampedes, stale content, Varnish and CloudFront failures.
- CI/CD 18GitHub Actions, GitLab CI, Jenkins, CircleCI: permissions, runners and…
- Client 21CORS, mixed content, module resolution, memory limits and framework runtime…
- Cloud 25IAM permissions, quotas, service limits and credential failures.
- Dart 10Null safety, pub version solving and build toolchain problems.
- Database 41Connections, deadlocks, constraints, replication and memory limits.
- DNS 10NXDOMAIN, SERVFAIL, timeouts, propagation and delegation problems.
- Docker 27Daemon connectivity, disk space, image pulls, ports and architecture mismatches.
- Elixir 9GenServer timeouts, supervision failures and Mix compilation problems.
- Email 8Delivery failures, relay denial, authentication, SPF, DKIM and DMARC.
- Frontend 23Hydration mismatches, bundler resolution, layout shift and font loading.
- Git 20Merge conflicts, rejected pushes, detached HEAD, LFS and repository corruption.
- Go 19Nil map assignment, concurrent map access, context cancellation and deadlocks.
- GraphQL 13Validation, depth limits, N+1 queries and fragment problems.
- gRPC 10Status codes, deadlines, message limits, TLS and HTTP/2 transport failures.
- HTTP 494xx client errors, 5xx server errors, redirects, headers and protocol problems.
- ICMP 23Destination unreachable, time exceeded, fragmentation needed and redirects.
- Ingress 8404 default backend, missing TLS secrets, IngressClass and path matching.
- Java 19Class loading, dependency resolution, connection pools and JVM version…
- JavaScript 42npm resolution, async pitfalls, hydration, memory limits and runtime type…
- Kubernetes 34CrashLoopBackOff, ImagePullBackOff, OOMKilled, RBAC, scheduling and storage.
- Logging 9Log4j, Logback, Fluentd, Logstash and CloudWatch ingestion problems.
- MessageQueue 14Kafka, RabbitMQ, SQS, NATS and Celery: lag, rebalancing and poison messages.
- Mobile 17Gradle, CocoaPods, Xcode signing, Metro bundler and toolchain mismatches.
- Monitoring 12Prometheus scrapes, Grafana data sources, OpenTelemetry exporters and agent…
- Network 35Refused connections, timeouts, resets, MTU problems and port exhaustion.
- Performance 6GC pauses, thread pool starvation and event loop blocking.
- PHP 11Memory limits, execution timeouts, autoloading, Composer and PDO connections.
- Proxy 17nginx, Envoy, HAProxy, Traefik, Caddy and Cloudflare upstream failures.
- Python 35Imports, virtual environments, encoding, concurrency and dependency conflicts.
- Regex 8Catastrophic backtracking, back references, escaping and engine differences.
- Ruby 11Bundler, migrations, native extensions, encoding and asset compilation.
- Rust 19Borrow checker, ownership moves, trait bounds and lifetime mismatches.
- Scala 6Dependency resolution, binary compatibility and type inference failures.
- Security 25JWT validation, CSRF, OAuth grants, SELinux, SSH host keys and CSP.
- Serverless 11Lambda timeouts, package size limits, VPC networking and cold starts.
- Shell 13Command not found, permissions, quoting, expansion and Makefile syntax.
- Storage 13S3 permissions, NFS mounts, quotas, signed URLs and volume attachment.
- Svelte 10Store subscriptions, load functions and server/client boundaries.
- System 26Disk space, systemd units, file descriptors, OOM killer and scheduled jobs.
- Terraform 18State locks, provider auth, drift, dependency cycles and plan-time unknowns.
- Testing 18Jest, pytest, JUnit, Cypress and Playwright: fixtures, snapshots and timeouts.
- TLS 24Untrusted authorities, expiry, hostname mismatch, chains and cipher negotiation.
- TypeScript 19Assignability, missing declarations, strict null checks and generic constraints.
- Virtualization 8VirtualBox, VMware, Hyper-V, WSL, KVM and hypervisor conflicts.
- Web3 7Gas estimation, nonce management and reverted transactions.
- WebAssembly 7Compile errors, memory bounds and host binding mismatches.
- WebServer 10nginx, Apache, IIS and Caddy: binding, permissions, rewrites and TLS.
- Windows 10Installer failures, missing runtimes, update errors and permission problems.