Errores comunes —
soluciones rápidas

Solución al error 'Cannot connect to the Docker daemon' en Docker. Causas principales y cómo resolverlo en Linux, macOS y Windows.

Solución completa al error 'command not found' en Bash/Linux/macOS. Entender el PATH, exportar variables y qué hacer cuando un programa instalado no se encuentra.

Explica por qué el z-index no funciona en CSS y cómo solucionar problemas de apilamiento de elementos. Stacking context, position y overflow explicados.

Cómo resolver los errores más comunes de ESLint: parsing errors, reglas desconocidas, conflictos con Prettier y la nueva configuración flat config.

Cómo depurar y solucionar 'Process completed with exit code 1' en GitHub Actions. Estrategias para identificar el paso fallido y sus causas.

Solución al error E11000 duplicate key en MongoDB. Cómo manejar índices únicos y evitar conflictos de duplicados en tus colecciones.

Cómo resolver el error de autenticación 'password authentication failed' en PostgreSQL. Solución para psql, pgAdmin, Prisma y connection strings.

Cómo resolver el error ModuleNotFoundError en Python. Diferencias entre entornos virtuales, pip y el intérprete correcto.

Cómo solucionar el error de Row Level Security (RLS) en Supabase. Configurar políticas RLS correctamente para INSERT, SELECT, UPDATE y DELETE.

Cómo resolver el warning de Vue 'Property or method is not defined on the instance'. Causas y soluciones para Vue 2 y Vue 3.

Cómo solucionar el error 'Module not found: Can't resolve' en Webpack. Causas por rutas incorrectas, alias no configurados y polyfills de Node.js.

Cómo resolver el error AccessDenied en AWS. Configurar políticas IAM correctamente para S3, Lambda, EC2 y otros servicios de AWS.

Cómo resolver 'no such table' en Django. Las migraciones no aplicadas son la causa más común. Guía paso a paso para gestionar migraciones correctamente.

Cómo resolver los errores más frecuentes en Go: index out of range, nil pointer dereference, interface conversion y deadlock.

Cómo resolver el error 'Cannot query field' en GraphQL. Causas por campos inexistentes, typos en el schema y cómo inspeccionar el schema con introspección.

Cómo diagnosticar y resolver CrashLoopBackOff en Kubernetes. Los pasos para ver logs, identificar la causa y corregir el pod que se reinicia en bucle.

Cómo resolver el error 'Target class does not exist' en Laravel. Causas por namespace incorrecto, rutas sin grupo y autoload desactualizado.

Cómo resolver el error 1045 'Access denied for user' en MySQL. Resetear la contraseña de root, crear usuarios y configurar permisos correctamente.

Cómo resolver los errores más comunes de Nginx: 502 Bad Gateway, puerto en uso, permisos y configuración incorrecta de proxy_pass.

Cómo resolver el error WRONGTYPE en Redis. Ocurre cuando intentas usar un comando de un tipo de dato sobre una clave que almacena otro tipo diferente.

Cómo entender y resolver los errores del borrow checker de Rust. Guía práctica para E0502, E0505, E0506 y los patrones para superarlos.

El navegador recibe HTML donde esperaba JavaScript. Error típico de rutas mal configuradas en Vite, webpack o React Router. Cómo identificarlo y solucionarlo.

Intentas desestructurar un objeto o array que todavía es undefined o null. Muy común con datos de API que aún no han cargado. Todas las soluciones.

Node.js o el navegador avisan de que una promesa falló y nadie capturó el error. Cómo identificar la promesa problemática y añadir manejo de errores correcto.

JSON.parse() recibe un string vacío, truncado o que no es JSON válido. Todas las causas posibles y cómo validar antes de parsear para evitar el crash.

Node.js rechaza usar require() con un paquete que solo exporta ES Modules. La causa es la guerra CJS vs ESM. Todas las soluciones sin reescribir tu proyecto.

Express responde 'Cannot GET /' porque no tienes definida esa ruta o los archivos estáticos no están configurados. Diagnóstico paso a paso para APIs y apps con frontend.

TypeScript detecta una incompatibilidad de tipos entre lo que tienes y lo que se espera. Cómo leer el error, corregir el tipo correcto y cuándo usar 'as' como último recurso.

Git no puede fusionar automáticamente dos ramas porque el mismo código fue modificado en ambas. Cómo leer los marcadores de conflicto y resolverlos correctamente.

¿Tu deploy falla con 'build failed exit code 1' en Netlify o Vercel? Causas reales y soluciones: case sensitivity, dependencias, Node.js y variables de entorno.

¿Vite no encuentra tus imports con @/? Solución para alias, rutas relativas, extensiones y tsconfig.json. Error típico al pegar código de IA.

¿Error de hidratación en Next.js o React? Causas reales (incluidas las provocadas por IA), solución paso a paso y cómo prevenirlo.

¿VS Code no abre la terminal integrada? Soluciones para Windows, Mac y Linux: PATH corrupto, shell por defecto, permisos y perfiles rotos.

La aplicación no puede conectar con PostgreSQL, MySQL u otra base de datos local. Las causas más comunes: el servicio no está corriendo, el puerto es incorrecto o las credenciales están mal.

localStorage no existe en el servidor — solo en el navegador. Error típico en Next.js, Astro y cualquier framework con SSR. Todas las soluciones para acceder a APIs del browser de forma segura.

Next.js bloquea imágenes externas por seguridad. Cómo añadir los dominios permitidos en next.config.js para que next/image funcione con URLs externas.

Git te avisa de que estás en 'detached HEAD' y cualquier commit que hagas puede perderse. Qué significa, cómo llegaste aquí y cómo volver a una rama de forma segura.

npm no encuentra el script que intentas ejecutar. Cómo ver los scripts disponibles, cuándo falta el script y cómo añadirlo o ejecutar el comando correcto.

React detecta que estás actualizando el estado de un componente durante la fase de renderizado de otro. Un patrón muy común en el que setState se llama sin useEffect.

Error de CORS al hacer fetch o axios? Solución para desarrollo y producción: proxy, headers del servidor y configuración correcta.

¿Error ERR_MODULE_NOT_FOUND al ejecutar Node.js? Causas y solución paso a paso: imports incorrectos, extensiones faltantes y package.json mal configurado.

Error ENOENT al ejecutar npm install, leer archivos o iniciar servidores Node.js? Causas y solución rápida paso a paso.

forEach no espera las promesas de los callbacks async. El código continúa sin esperar a que terminen. Por qué ocurre y cómo iterar arrays de forma asíncrona correctamente.

process.env.MI_VARIABLE devuelve undefined en Next.js aunque la hayas definido. Las reglas de prefijos NEXT_PUBLIC_, cuándo se leen y cómo depurar el problema.

Prisma lanza este error al intentar insertar un valor que ya existe en un campo marcado como único. Cómo capturar el error correctamente y devolver mensajes útiles al usuario.

Añades clases de Tailwind y no pasan nada. Las causas más frecuentes: content paths mal configurados, clases generadas dinámicamente, especificidad CSS o build sin reiniciar.

npm no puede resolver el árbol de dependencias por conflicto de peer dependencies. Solución paso a paso sin romper el proyecto.

jsonwebtoken lanza este error cuando la clave secreta es undefined. Casi siempre por una variable de entorno no cargada. Cómo diagnosticarlo y proteger la generación de tokens.

Node.js lanza SyntaxError al usar import/export de ES Modules. Tres formas de solucionarlo según tu proyecto: package.json, extensión .mjs o configuración de Babel/TypeScript.

TypeScript no reconoce process, __dirname, Buffer u otras APIs globales de Node.js porque faltan los tipos @types/node. Instalación y configuración correcta.

Node.js no puede arrancar porque el puerto ya está ocupado por otro proceso. Cómo encontrar y matar el proceso en Windows, Mac y Linux, y cómo evitarlo.

React lanza 'Invalid hook call' cuando usas un hook en un lugar no permitido. Las tres causas más comunes y cómo identificar cuál es la tuya.

React avisa de que los elementos de una lista no tienen key o tienen keys duplicadas. Por qué importa y cómo elegir la key correcta.

JavaScript lanza 'is not a function' cuando intentas llamar como función algo que no lo es. Las causas más frecuentes y cómo depurarlo rápido.

JavaScript ha agotado el call stack por recursión infinita o referencias circulares. Cómo identificarlo con el stack trace y las soluciones más comunes.

Git rechaza el push porque el remoto tiene commits que no tienes en local. Cómo resolverlo sin perder trabajo ni reescribir el historial del equipo.

Node.js lanza ReferenceError al usar fetch() porque no está disponible de forma nativa en versiones antiguas. Soluciones para Node 16, 17 y cómo usar el fetch nativo en Node 18+.

Prisma lanza PrismaClientInitializationError al no encontrar el cliente generado. Solución: ejecutar prisma generate y configurar la instancia correctamente en Next.js.

TypeScript no encuentra el módulo o le faltan los tipos. Causas habituales: paquete sin instalar, tipos @types faltantes, paths mal configurados o imports con extensión errónea.

React entra en bucle infinito de re-renders. Causas: setState en el render, useEffect sin dependencias correcto, o event handler llamado inmediatamente.

Error al intentar renderizar un objeto directamente en JSX. Causas comunes: renderizar un Date, un objeto de error, o datos sin procesar de una API.

Error al hacer .map() sobre una variable undefined en React. Solución con valor por defecto, optional chaining y manejo de estado de carga.

npm no puede instalar paquetes por permisos insuficientes en Mac o Linux. Solución correcta sin usar sudo npm install.