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.