{"canonical_url":"https://engineer.company/es/glossary/nextjs/","content_markdown":"# Next.js\n\n## Qué es\n\nNext.js es un marco de trabajo que envuelve React, la biblioteca para construir\ninterfaces de usuario con componentes, y aporta lo que React deja a cada\naplicación: enrutamiento, renderizado en el servidor, obtención de datos y una\ncompilación ya configurada. Tanto el paquete como su orden se llaman `next`, como\nen `next dev` y `next build`.\n\nSe publicó por primera vez en 2016 para, [según sus autores](https://nextjs.org/blog/next-13-4), «ofrecer una forma sencilla de\nrenderizar aplicaciones React en el servidor». El diseño inicial se basaba en\nunos pocos principios: ninguna configuración inicial; el sistema de archivos\ncomo API, de modo que un archivo en `pages/` se convertía en una ruta; renderizado en\nservidor y división del código automáticos; y obtención de datos a cargo del\ndesarrollador. En 2023, las notas de versión ya reconocían a más de 2.600\ndesarrolladores junto al equipo principal de Vercel.\n\nNext.js 13 añadió el 25 de octubre de 2022 un directorio `app` en beta, basado en\n[React Server Components](https://react.dev/reference/rsc/server-components), con diseños anidados y transmisión progresiva. Next.js 13.4 declaró estable\nApp Router el 4 de mayo de 2023; desde entonces, la documentación describe dos\nenrutadores. Pages Router es «el enrutador original, aún mantenido y en mejora».\nDifieren incluso en la versión de React que ejecutan: App Router incorpora versiones canary\nde React, mientras Pages Router utiliza la versión que indique el `package.json` del\nproyecto. En App Router, las páginas y los diseños se renderizan en el servidor,\nsalvo que un archivo elija ejecutarse en el navegador con la directiva `\"use client\"`.\n\nNext.js 16 llegó el 21 de octubre de 2025. Convirtió Turbopack en el\nempaquetador predeterminado, cambió el nombre de `middleware.ts` a `proxy.ts` e introdujo Cache\nComponents: un modelo donde la directiva `\"use\ncache\"` marca lo que puede almacenarse en\ncaché y todo lo demás se renderiza al recibir la solicitud. Next.js 16.4, del 6\nde octubre de 2026, recomienda Cache Components para todas las aplicaciones,\nactiva ese modelo en proyectos nuevos creados con `create-next-app` y anuncia que «será la\nopción predeterminada en Next.js 17».\n\n## Por qué importa\n\nLa decisión que resuelve Next.js es si dejar que un marco de trabajo controle el\nenrutamiento, el renderizado y el servidor de una aplicación React o montar esas\npiezas por su cuenta y mantener el control sobre esas decisiones.\n\nOfrece convenciones en lugar de configuración. Las rutas nacen de archivos, los\nempaquetadores y compiladores se configuran automáticamente y cada ruta puede\nconstruirse de antemano, renderizarse en el servidor por solicitud o\nrenderizarse en el navegador. Los Server Components mantienen el acceso a los\ndatos y los secretos en el servidor y envían menos JavaScript al navegador. Para\nuna aplicación que combina páginas públicas, una zona con sesión iniciada y su\npropio backend, esa elección por ruta es el principal atractivo.\n\nEl primer coste es un servidor con Node.js 20.9 o posterior para Next.js 16. El\najuste `output: 'export'` escribe un archivo HTML por ruta para cualquier servidor web\nestático; la guía lo presenta como una forma de empezar con contenido estático y\nañadir funciones de servidor después. Sin embargo, la lista de lo que exige un\nservidor Node.js abarca buena parte de lo que distingue a Next.js: Proxy, Server\nActions, cookies, reescrituras, redirecciones, cabeceras, Incremental Static\nRegeneration y optimización de imágenes con el cargador predeterminado.\n\nEl segundo coste es el ritmo. En un año hubo cuatro versiones funcionales\ndespués de 16.0, y el modelo de caché está a punto de volver a cambiar su opción\npredeterminada. Las notas de 16.4 dicen que el modelo Cache Components sustituye\n«los comportamientos implícitos de caché de versiones anteriores de App Router»:\nel código escrito para Next.js 13 a 15 utiliza otras reglas de caché. Los\ntutoriales de Internet también se reparten entre ambos enrutadores.\n\nEl tercer coste es que actualizar también es trabajo de seguridad. El 3 de\ndiciembre de 2025, el proyecto publicó un aviso sobre CVE-2025-66478, una\nvulnerabilidad crítica del protocolo React Server Components, e indicó que se\nactualizara inmediatamente a versiones corregidas. El blog publicó otros tres\nartículos de seguridad entre el 30 de septiembre y el 14 de octubre de 2026.\nAdoptar Next.js obliga al equipo a seguir sus versiones de cerca. Un equipo que\npublica documentos iguales para todos los visitantes paga por un modelo de\nservidor que apenas utiliza.\n\n## Cómo se aplica en la práctica\n\nEn el trabajo de la fundadora en NextMariner, la interfaz Next.js 16 [renderiza cada parte de la forma que le corresponde](/es/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/): es la\nelección por ruta llevada a la práctica. Las páginas públicas y de marketing se\ngeneran estáticamente; las partes realmente interactivas siguen renderizándose\nen el cliente. En el panel autenticado y los grandes listados de directorio, una\nfactoría, `createPrefetchedServerPage`, obtiene los datos de la página en el servidor y los entrega al\ncliente ya cargados. Las páginas pasan a la factoría de una en una; el caso\nreconoce que el resto de la aplicación autenticada sigue renderizándose en el\ncliente, pendiente de migración: «una migración con un mecanismo que funciona y\nla siguiente página por migrar claramente identificada, en lugar de una\nconversión completa». App Router se diseñó para ese tipo de traslado; las notas\nde 13.4 describen su adopción incremental.\n\nUn [conjunto de pruebas por capas](/es/portfolio/built-a-test-suite-across-go-sql-and-browser/) da una capa propia a la interfaz Next.js: 543 especificaciones Vitest y\nPlaywright, incluidos 48 archivos de extremo a extremo y 30 especificaciones de\nnavegador, junto a capas separadas para la API Go y la base de datos. Cada capa\nse comprueba donde reside su comportamiento, en lugar de probarlo todo desde un\nnavegador. Importa en un marco cuyo árbol de componentes se ejecuta en parte en\nel servidor y en parte en el navegador.\n\nCuando la fundadora, trabajando en NextMariner, [reforzó la seguridad de una aplicación](/es/portfolio/hardened-the-application-with-nonce-based-csp/), las protecciones orientadas\nal navegador se incorporaron a `proxy.ts`, el middleware renombrado. Establece una\nContent-Security-Policy con un nonce por solicitud y `strict-dynamic`, además de HSTS y\ncookies SameSite. La autorización reside en otro lugar: los derechos de acceso,\nque abarcan nivel, rol, organización y alcance por buque, vuelven a comprobarse\nen el servidor en cada solicitud; los controles de la interfaz solo cuentan como\nexperiencia de usuario. Esa división coincide con la referencia de Proxy, que\nconsidera la función un último recurso e indica que se verifique la autorización\n«dentro de cada Server Function, en lugar de depender solo de Proxy».\n\n## Dónde surgen los problemas\n\n**Tras añadir una redirección de acceso, la página de inicio de sesión carga sin\nestilos.** Sin un `matcher`, Proxy se ejecuta en cada solicitud, incluidos los\narchivos compilados de `_next/static`, las imágenes optimizadas de `_next/image` y todo lo que haya\nen `public/`. Una redirección destinada a páginas alcanza también el CSS, JavaScript y\nlas imágenes que necesita la página de acceso. Asigne a Proxy un patrón que\nomita esas rutas:\n\n```ts\n// proxy.ts\nexport const config = {\n    matcher: [\"/((?!_next/static|_next/image|favicon.ico).*)\"],\n};\n```\n\nLos archivos de `public/` no comparten prefijo: añada también sus rutas.\n\n**Una acción de formulario funciona sin sesión en una ruta que parece\nprotegida.** Las Server Functions no tienen rutas propias: llegan como\nsolicitudes POST a la página donde se utilizan. Si un patrón omite una ruta,\ntambién omite sus funciones. La referencia de Proxy advierte de que cambiar el\npatrón o mover una función a otra ruta al refactorizar «puede eliminar\nsilenciosamente la cobertura de Proxy». Compruebe la sesión y los permisos del\nusuario dentro de cada Server Function; trate Proxy como una capa exterior,\nnunca como la única.\n\n**Un usuario guarda un cambio y la página sigue mostrando el valor anterior.**\nEn Next.js 16, `revalidateTag(tag,\n'max')` aplica a las entradas etiquetadas el comportamiento\nstale-while-revalidate: sigue sirviéndose la copia en caché mientras se obtiene\notra nueva. Es adecuado para contenido que tolera consistencia eventual, pero\nsorprende a quien acaba de pulsar Guardar. Llame a `updateTag(tag)` desde la Server Action\nque realizó el cambio: caduca la entrada y lee datos actualizados dentro de la\nmisma solicitud. La antigua llamada `revalidateTag(tag)` con un solo argumento está obsoleta y\nahora provoca un error de TypeScript.\n\n**Termina el codemod de actualización, pero la compilación sigue fallando en `params`\no `cookies()`.** Next.js 15 convirtió las API de solicitud en asíncronas, con\ncompatibilidad síncrona temporal; Next.js 16 la elimina. El codemod `upgrade` no\nejecuta todas las migraciones: ejecute también `npx @next/codemod@canary next-async-request-api .` y después `npx next typegen` para generar\nlos auxiliares `PageProps`, `LayoutProps` y `RouteContext`. La misma actualización elimina `next lint` y hace que `next build`\ndeje de ejecutar el análisis estático; añada ESLint o Biome como paso\nindependiente.\n\n## Lecturas adicionales\n\n- [Documentación de Next.js](https://nextjs.org/docs) — la documentación oficial, con un selector entre las versiones App Router\n  y Pages Router de cada página.\n- [Next.js 16](https://nextjs.org/blog/next-16) — la versión que introdujo Cache Components, `proxy.ts` y Turbopack como\n  empaquetador predeterminado, con sus cambios incompatibles.\n- [Cómo actualizar a la versión 16](https://nextjs.org/docs/app/guides/upgrading/version-16) — los codemods, los requisitos de versión y todas las API eliminadas o\n  renombradas.\n- [proxy.js](https://nextjs.org/docs/app/api-reference/file-conventions/proxy) — los patrones de selección, la posición de Proxy en el orden de las\n  solicitudes y por qué se renombró middleware.\n- [Next.js 16.4](https://nextjs.org/blog/next-16-4) — los argumentos a favor de Cache Components y el plan para convertirlo en\n  opción predeterminada en Next.js 17.\n- [Cómo crear una exportación estática](https://nextjs.org/docs/app/guides/static-exports) — qué funciones necesitan servidor y qué escribe `output: 'export'`.\n\n\u003chttps://engineer.company/es/glossary/nextjs/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Next.js añade a React rutas, renderizado y servidor. Sus modos por ruta aportan ventajas, pero exigen cuidar caché, autorización y actualizaciones.","formats":{"gemtext":"https://engineer.company/es/glossary/nextjs/index.gmi","gopher":"https://engineer.company/es/glossary/nextjs/gophermap","html":"https://engineer.company/es/glossary/nextjs/","json":"https://engineer.company/es/glossary/nextjs/index.json","markdown":"https://engineer.company/es/glossary/nextjs/index.md","pdf":"https://engineer.company/es/glossary/nextjs/index.pdf"},"kind":"page","language":"es","title":"¿Qué es Next.js?","url":"https://engineer.company/es/glossary/nextjs/","version":1}