Saltar al contenido
Cursos/Crea webs profesionales con IA desde cero/Laboratorio: descubre un fallo que solo aparece en producción

Laboratorio: descubre un fallo que solo aparece en producción

Distingue `dev`, `build` y `start` y corrige una dependencia de entorno antes de desplegar.

Lección 33 de 4780 min Laboratorio reproducible Codex + GPT-5.6 Sol

Resultado visible

Distinguirás el servidor de desarrollo de una compilación de producción. Detectarás una variable o importación problemática antes de Vercel.

Estado roto

En una copia, referencia una variable obligatoria solo durante la construcción o importa un módulo de servidor desde un componente cliente. Comprueba que npm run dev puede no recorrer esa ruta inmediatamente.

Reproduce

npm run lint
npx tsc --noEmit
npm run build
npm run start

Ejecuta cada comando por separado y conserva la primera salida relevante. No pegues valores de variables. next build no ejecuta automáticamente el linter en Next.js 16, por eso son comprobaciones distintas.

Prompt de corrección

Reproduce el fallo con una compilación de producción. Explica por qué dev
no lo mostró. Identifica si la causa es variable ausente, frontera cliente/
servidor, API dinámica, dependencia o configuración. Aplica la corrección
mínima y añade una prueba que falle si regresa. Ejecuta lint, TypeScript,
build y start; visita la ruta afectada. No cambies de runtime ni proveedor
para ocultar el error.

Verificación y restauración

La compilación termina, start sirve la ruta y el navegador no muestra errores. Documenta las variables por nombre en .env.example. Revierte el defecto intencionado y conserva la prueba.

Fuentes oficiales