Client-Side & Browser Errors
CORS, mixed content, module resolution, memory limits and framework runtime errors.
Understanding Client errors
Client-side errors are what the browser console shows when something the page depends on cannot be loaded, parsed or executed. Two patterns dominate: the browser refused to make or read a request (CORS, mixed content, cookie policy), and the bundler or runtime could not resolve a module. Both produce alarming messages that point at the wrong file, so read the network tab before the stack trace.
How to debug Client errors
- Open devtools and look at the failing request in the Network tab, not just the console message. CORS errors always have a real underlying response, or a real absence of one, that the console hides.
- For CORS, remember the fix belongs on the server. No client-side change can grant your page access; browser extensions that appear to fix it only mask the problem in development.
- Distinguish a preflight failure from a main-request failure. If you see an
OPTIONSrequest in the network tab that returns a non-2xx, the server is not handling preflight at all. - For module resolution errors, check the exact specifier, the file extension and the case of the path. Case-insensitive filesystems on macOS and Windows hide errors that appear only on Linux CI.
- Test in a private window with extensions disabled. Ad blockers and privacy extensions cause a surprising share of reported "CORS" and "network" errors.
Tools worth reaching for
Browser devtools (Network + Console)curl -H 'Origin: …' -X OPTIONS -iLighthouseprivate/incognito window
All 21 Client errors
- Angular: Can't resolve all parametersAngular dependency injection cannot resolve constructor parameters. Missing providers, circular dependencies, or…
- Browser warning: Cookie has no SameSite attributeModern browsers default cookies without SameSite to Lax, which may break cross-site login, embedded widgets, or…
- CORS policy errorCross-Origin Resource Sharing policy blocked the request. Browser security feature preventing unauthorised…
- docker: permission deniedUser lacks permissions to access the Docker daemon socket. Docker daemon requires root privileges or docker group…
- Failed to fetch dynamically imported module NewA single-page app that was loaded before a deployment tried to lazy-load a chunk whose hashed filename no longer…
- FATAL ERROR: JavaScript heap out of memoryNode.js process has exceeded the default memory limit (typically ~1.7GB). Large datasets, memory leaks, or…
- [email protected]: Permission denied (publickey)Git cannot authenticate with the remote repository using SSH keys. SSH key is missing, incorrect, or not added to the…
- IndentationError: unexpected indentPython code has inconsistent indentation. Mixed tabs and spaces, or incorrect indentation level for the code block.
- Java: java.lang.ClassNotFoundExceptionApplication tries to load a class through its string name but no definition for the class with the specified name…
- Java: java.lang.NullPointerExceptionAttempting to use an object reference that has not been initialised (is null).
- java.lang.OutOfMemoryErrorJava application has exhausted available heap memory. Memory leak, insufficient heap size, or processing too much data.
- JSON parse errorClient received invalid JSON response that cannot be parsed, often due to malformed syntax.
- Mixed Content ErrorHTTPS page trying to load insecure HTTP resources. Browsers block HTTP content on HTTPS pages for security.
- Module not found: Can't resolve 'X'Webpack cannot find the specified module. Incorrect import path, missing dependency, or case-sensitive file system…
- ModuleNotFoundError: No module named 'X'Python cannot find the specified module. Module is not installed, wrong Python environment, or incorrect PYTHONPATH.
- npm EACCES: permission deniednpm lacks permissions to write to the global directory. Often happens when trying to install packages globally without…
- npm ERR! enoent ENOENT: no such file or directory, open 'package.json'npm command was run in a directory without a package.json file. npm expects to be run from a Node.js project directory.
- React Hook useEffect has missing dependenciesReact Hook has dependencies that are not included in the dependency array, potentially causing stale closures or…
- Safari: third-party cookie blocked (ITP)Safari's Intelligent Tracking Prevention blocks cookies in third-party contexts such as iframes, embedded SSO, and…
- TypeScript: Cannot find module 'X'TypeScript cannot resolve module imports. Missing type definitions, incorrect tsconfig.json, or module resolution…
- Vue template compilation failedVue template contains syntax errors or uses features not available in the current Vue version. Invalid directives or…
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# 12NuGet restore, null references, EF Core migrations, async deadlocks and Blazor…
- 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…
- 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.