50 · Biblioteca de errores
Biblioteca de errores
Busca por el texto exacto que ves. Cada entrada explica qué significa, las causas probables y qué decirle a tu agente.
Terminal
Error: listen EADDRINUSE: address already in use :::3000TerminalOtro programa ya usa el puerto 3000, así que tu app no puede arrancar ahí.zsh: command not found: ghTerminalTu equipo no encuentra GitHub CLI: no está instalada o la app arrancó antes de instalarla.zsh: command not found: nodeTerminalTu equipo no encuentra Node.js, la herramienta que ejecuta tu app en local.zsh: command not found: gitTerminalTu equipo todavía no tiene Git instalado, así que no puede guardar puntos de control de tu proyecto.npm error code EACCES: permission denied, mkdir '/usr/local/lib/node_modules/...'TerminalUn comando intentó instalar un paquete en una carpeta protegida del sistema en lugar de hacerlo dentro de tu proyecto.npm error code ENOENT: syscall open '.../package.json' — Could not read package.jsonTerminalLa terminal se está ejecutando en una carpeta que todavía no contiene tu app de Next.js.npm error code ERESOLVE: unable to resolve dependency treeTerminalDos paquetes de tu proyecto piden versiones incompatibles de otro paquete.xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrunTerminal (Mac)Tras actualizar macOS, tu Mac necesita volver a instalar o aceptar las herramientas de línea de comandos de Apple para que Git funcione.sh: next: command not foundTerminalIntentaste arrancar la app (`npm run dev`), pero sus paquetes (`node_modules`) todavía no están instalados en esta carpeta.Navegador
Error: Hydration failed because the server rendered HTML didn't match the client.Consola del navegadorLa página se veía de una forma cuando la construyó el servidor y de otra en el navegador.TypeError: Cannot read properties of undefined (reading '…')Navegador o terminalEl código intentó leer un dato dentro de un elemento que está vacío (`undefined`) sin comprobar antes si existe.Error: Objects are not valid as a React child (found: object with keys {…})NavegadorUn componente intentó mostrar un objeto entero de datos o una fecha `Date` directamente en pantalla en lugar de un texto o un número.Error: Too many re-renders. React limits the number of renders to prevent an infinite loop.NavegadorUn componente actualiza su propio estado cada vez que se dibuja, creando un bucle sin fin que React detiene.TypeError: Failed to fetchConsola del navegadorEl navegador intentó comunicarse con tu servidor o con una dirección externa y no pudo conectar.ChunkLoadError: Loading chunk app/page failed.NavegadorEl navegador intentó cargar una parte del código de tu app que cambió o se reconstruyó desde que abriste la página.Error: Secret API key must not use the NEXT_PUBLIC_ prefixNavegador o terminalSe puso el prefijo `NEXT_PUBLIC_` a una clave secreta, lo que envía su valor al navegador de cada visitante.Build en Vercel
Module not found: Can't resolve '…'Terminal o navegadorEl código importa un paquete o archivo que no está.Type error: Property '…' does not exist on type '…'.Logs de build en Vercel o terminalTypeScript detectó que los datos reales no coinciden con la forma que el código espera.Failed to compile. Error: '…' is defined but never used. (@typescript-eslint/no-unused-vars)Logs de build en Vercel o terminalEl control de calidad del código (ESLint) detuvo el build porque quedó una variable o importación que no se usa.npm error Missing script: "build" — Error: Command "npm run build" exited with 1Logs de build en VercelVercel intentó construir tu web, pero la raíz del repositorio no tiene un `package.json` de Next.js con el comando `build`.Error: Found invalid Node.js Version: "18.x". Please set Node.js Version to 22.x in Project Settings.Logs de build en VercelLa versión de Node.js configurada en Vercel no coincide con la versión LTS actual que requieren tus paquetes.Module not found: Error: Can't resolve './components/Button' in '/vercel/path0/app'Logs de build en Vercel (funciona en local, falla en Vercel)Las mayúsculas o minúsculas de un `import` no coinciden exactamente con el nombre real del archivo. Mac y Windows lo pasan por alto, pero los servidores Linux de Vercel exigen coincidencia exacta.DynamicServerError: Dynamic server usage: Route /… couldn't be rendered statically because it used `cookies` or `headers`.Logs de build en Vercel o terminalNext.js intentó preconstruir una página como HTML fijo durante el build, pero la página lee las cookies de sesión o las cabeceras del visitante actual.useSearchParams() should be wrapped in a suspense boundary at page "/…".Logs de build en Vercel o `npm run build`Un componente de cliente lee parámetros de la URL con `useSearchParams()`, y Next.js necesita envolverlo en `<Suspense>` para poder cargar el resto de la página al instante.Ejecución en Vercel
504: GATEWAY_TIMEOUT — Code: FUNCTION_INVOCATION_TIMEOUTVista previa o web en producción en VercelUna acción del servidor o ruta de API tardó demasiado en terminar, así que Vercel dejó de esperar y cortó la petición.500: INTERNAL_SERVER_ERROR — Code: FUNCTION_INVOCATION_FAILEDVista previa o web en producción en VercelAlgo falló en el servidor al procesar la petición. Vercel oculta el fallo técnico al visitante y guarda la causa real en los logs de ejecución.Error: The Edge Runtime does not support Node.js '…' module.Logs de Vercel o terminalUna ruta o middleware configurado en el entorno ligero Edge importó un paquete que necesita Node.js completo.413: FUNCTION_PAYLOAD_TOO_LARGE — Request Entity Too LargeNavegador o logs de ejecución en VercelEl navegador intentó enviar un archivo o petición más grande que el límite permitido para una petición al servidor (4,5 MB en Vercel).Error: Missing required environment variable: TOKENTIDE_API_KEY is undefinedTerminal o logs de ejecución en VercelTu app buscó una variable de entorno (como una clave de API o la URL de la base de datos) y no está configurada en el entorno donde se está ejecutando.BetterAuthError: BETTER_AUTH_SECRET is not set or is too shortTerminal o logs de ejecución en VercelBetter Auth necesita un secreto aleatorio (`BETTER_AUTH_SECRET`) para firmar las cookies de sesión con seguridad, y aún no se ha generado en este entorno.BetterAuthError: Invalid origin: https://…-git-….vercel.app is not a trusted originLogs de vista previa en Vercel o navegadorIntentaste iniciar sesión en un enlace de vista previa de Vercel y Better Auth bloqueó la petición porque aún no tiene configuradas como confiables las direcciones de vista previa de tu proyecto.Git y GitHub
Author identity unknown *** Please tell me who you are.TerminalGit necesita un nombre y un correo para firmar tus puntos de guardado (commits), y aún no están configurados en este equipo.! [rejected] main -> main (non-fast-forward) — error: failed to push some refsTerminalGitHub tiene puntos de guardado más recientes que aún no están en tu equipo, así que Git detuvo el push para no sobrescribirlos.git@github.com: Permission denied (publickey). fatal: Could not read from remote repository.TerminalGit intentó conectarse a GitHub usando claves SSH en lugar de tu conexión HTTPS iniciada con GitHub CLI.You are not logged into any GitHub hosts. Run gh auth login to authenticate.TerminalGitHub CLI (`gh`) todavía no está conectada a tu cuenta de GitHub en este equipo, o la sesión ha caducado.fatal: not a git repository (or any of the parent directories): .gitTerminalSe intentó usar Git en una carpeta donde todavía no se ha activado Git (no hay carpeta `.git`).CONFLICT (content): Merge conflict in … — Automatic merge failed; fix conflicts and then commit the result.TerminalDos ramas modificaron exactamente las mismas líneas de un archivo de forma distinta, así que Git pregunta qué versión conservar.remote: error: GH013: Repository rule violations found — Push cannot contain secretsTerminalGitHub revisó los commits que ibas a subir, detectó una clave de API o secreto real dentro de un archivo y bloqueó el push para proteger tu cuenta.Base de datos (Neon / Postgres)
NeonDbError: password authentication failed for user 'neondb_owner'Terminal o logs de ejecución en VercelTu app llegó hasta la base de datos de Neon, pero la contraseña incluida en `DATABASE_URL` no es correcta o se restableció.NeonDbError: relation "…" does not existTerminal o logs de ejecución en VercelTu código consultó una tabla de la base de datos (Postgres llama «relation» a cada tabla) que todavía no se ha creado en esta rama de la base de datos.Error: Connection terminated unexpectedly / ETIMEDOUT connecting to *.neon.techTerminal o logs de ejecución en VercelTu app intentó abrir una conexión con Neon y no recibió respuesta a tiempo.NeonDbError: sorry, too many clients already / remaining connection slots are reservedTerminal o logs de ejecución en VercelSe abrieron demasiadas conexiones simultáneas a la base de datos sin reutilizarlas ni agruparlas.NeonDbError: duplicate key value violates unique constraint "…"Terminal o logs de ejecución en VercelLa app intentó guardar un dato (como un correo, nombre de usuario o slug) que ya existe en una columna donde cada fila debe ser única.NeonDbError: null value in column "…" of relation "…" violates not-null constraintTerminal o logs de ejecución en VercelLa base de datos rechazó guardar una fila porque una columna obligatoria llegó vacía (`null`).Proveedor de IA (Tokentide / Gateway)
AI_APICallError: 401 invalid_api_key — Incorrect or revoked Tokentide API keyTerminal o logs de ejecución en VercelTokentide rechazó `TOKENTIDE_API_KEY` porque la clave está incompleta, fue revocada o no empieza por `tt_live_`.AI_APICallError: 402 Payment Required — Insufficient balance or daily spend cap reachedTerminal o logs de ejecución en VercelTokentide rechazó la petición antes de ejecutarla porque se agotó tu saldo prepago o la clave alcanzó su tope de gasto diario.AI_APICallError: 403 model_not_allowed — Model requires privacy mode 'all' or is not in the catalogTerminal o logs de ejecución en VercelTu código pidió a Tokentide un modelo que el modo de privacidad de tu clave no permite, o usó un identificador de modelo mal escrito. A diferencia de 503 o 429, `403 model_not_allowed` debe corregirse en la configuración.AI_APICallError: 429 Too Many Requests — Rate limit exceeded (Retry-After: …)Terminal o logs de ejecución en VercelSe enviaron demasiadas peticiones de IA en muy poco tiempo. Tokentide rechazó la petición extra sin cobrarla e indicó en `Retry-After` cuántos segundos usar el respaldo.AI_APICallError: 503 Service Unavailable — No discounted capacity available right nowTerminal o logs de ejecución en VercelLa capacidad con descuento de Tokentide para ese modelo está llena en este momento. Nunca se cobra un 503 y tu app debe responder al instante usando el respaldo de Vercel AI Gateway.AI_NoObjectGeneratedError: No object generated: could not parse or validate the response against schema.Terminal o logs de ejecución en VercelTu app pidió al modelo de IA datos estructurados según un esquema, y la respuesta se cortó a mitad o no cumplió con los campos requeridos.50 entradas de errores habituales en la terminal, el navegador, Vercel, GitHub, base de datos e IA.
¿Te ha resultado útil esta página?