Logs de build en Vercel o `npm run build`

useSearchParams() should be wrapped in a suspense boundary at page "/…".

Qué significa
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.
Causas probables
  • Usar useSearchParams() en un componente de cliente sin envolverlo en <Suspense fallback={...}> en la página que lo contiene.
  • Probar solo con npm run dev (que no preconstruye las páginas) en lugar de ejecutar npm run build antes de hacer push.
Cómo evitarlo
Ejecuta npm run build en local antes de abrir una pull request para detectar estos avisos a tiempo.

Copia para tu agente

El build falló con `useSearchParams() should be wrapped in a suspense boundary`. Envuelve el componente que usa `useSearchParams()` en `<Suspense>` y compruébalo con `npm run build`.

Artículo de ayuda completoFalló el build en Vercel

Última revisión 8 nov 2026