# PRNext y Next.js: guía de compatibilidad y migración ¿Quiere probar PRNext en una aplicación Next.js sin encontrar una incompatibilidad durante la implementación? Comience con una copia aislada, una versión identificada y una ruta de verificación que cubra el uso real. Esta guía documenta PRNext 0.1.18-alpha, disponible el npm en octubre 30, 2026. Next.js. La compatibilidad sigue siendo parcial. Una importación reconocida o una compilación exitosa por sí sola no establece la compatibilidad de la aplicación. ## Alinear la versión y los requisitos previos Esta versión declara Nodo ^22.23.4 || ^24.22.1 || >=26.12.1. Sus pares React, React DOM y react-server-dom-webpack son 19.3.1. Mantenga habilitadas las dependencias nativas opcionales: el componente nativo debe coincidir con la versión del marco. Los siguientes comandos utilizan npm. Conserve pnpm o Yarn si el proyecto ya los utiliza y lea la documentación enviada en el paquete. Trabaje en una rama o copia aislada, conservando el archivo de bloqueo original. Los paquetes nativos publicados no requieren que los consumidores instalen Rust. ```sh node --version npm install --save-exact @thomas.f/prnext@0.1.18-alpha react@19.3.1 react-dom@19.3.1 react-server-dom-webpack@19.3.1 npx --no-install prnext migrate --dry-run npx --no-install prnext migrate --check --json ``` ## Identificar características que necesitan controles específicos Las convenciones de enrutamiento, los componentes del servidor, las acciones, la navegación y los estilos se encuentran entre las áreas adaptadas por PRNext. El alcance depende de la configuración y de la ruta ejecutada. Esta matriz identifica comprobaciones de aplicaciones en lugar de asignar compatibilidad universal a cada familia de funciones. Las comprobaciones de PRNext 0.1.18-alpha. deben observarse en su solicitud. | Área | Verificación útil | | --- | --- | | Enrutador de aplicaciones y páginas | Rutas concretas, parámetros, errores y navegación. | | RSC y acciones del servidor | Renderizado, formularios, sesiones y manejo de fallas. | | Configuración y complementos | Claves aceptadas y comportamiento de construcción real. | | Imágenes y fuentes | Carga, generación y salida del navegador. | | Cachés y revalidación | Frescura, aislamiento de usuarios y múltiples procesos. | | Enrutamiento avanzado | Las ramas paralelas e interceptoras que utilizas | | importaciones siguientes/dist | Un adaptador privado explícito o una dependencia aislada | ## Lea el plan antes de aplicar la migración. El ensayo le permite revisar los cambios de dependencia y secuencia de comandos propuestos. La auditoría también debe identificar conflictos de configuración y origen. Mantenga un archivo next.config.* o prnext.config.*; cambiarle el nombre no hace que se admita una opción Next.js desconocida. Cuando el plan sea apropiado, aplique la migración, verifique la configuración y cree. typecheck requiere TypeScript y un tsconfig en la aplicación. La migración retiene fuentes y Next.js; Las importaciones públicas next/* pueden permanecer. Evite reemplazos de importaciones generales u ocultar conflictos entre pares con --force. ```sh npx --no-install prnext migrate npx --no-install prnext check --json npx --no-install prnext typecheck npx --no-install prnext build ``` ## Comparar respuestas de servidores separados Inicie la referencia Next.js en un puerto disponible y el candidato en otro. paths.json contiene una matriz JSON de rutas concretas, como ["/", "/products/demo", "/api/health"], reemplazadas con las rutas de su aplicación. Mantenga las cookies y los secretos fuera de él. El comparador verifica muestras de respuestas GET públicas. No autentica solicitudes ni sigue redirecciones. Sus tiempos no son un punto de referencia controlado. Un resultado favorable aún requiere comprobaciones del navegador en busca de estilo, hidratación, mutaciones y estados autenticados. ```sh npx --no-install prnext migrate --check --against http://127.0.0.1:3000 --candidate http://127.0.0.1:3001 --routes paths.json ``` ## Verificar los viajes que hacen que el producto funcione. Ejercicio de inicio de sesión, cierre de sesión y una acción comercial. Consulta de nuevo navegación, errores, estados de carga y cookies. Para un formulario, verifique tanto el resultado almacenado como el estado mostrado después de la respuesta. El estado HTTP no describe toda la interacción. Agregue comprobaciones de aislamiento con dos sesiones: las respuestas privadas y los datos almacenados en caché no deben cruzarse entre ellas. Si utiliza importaciones privadas Next.js, cargadores personalizados o enrutamiento avanzado, mantenga un ejemplo mínimo de la ruta probada. Esas dependencias pueden cambiar la evaluación. ## Decidir después de la verificación funcional. Mantenga la versión exacta, el archivo de bloqueo, los casos probados y cualquier incompatibilidad. Si falta una característica, identifique el API y el escenario involucrado. Una limitación precisa es más útil que un porcentaje de compatibilidad general. Luego mida rutas costosas bajo las mismas limitaciones de recursos. Conserve la referencia hasta que el candidato cumpla con sus criterios. Las migraciones de bases de datos necesitan su propio plan de reversión; restaurar package.json no los deshace. [Elija PRNext para los requisitos de su aplicación](/es/blog/is-prnext-right-for-your-app) [Medida SSR después de la verificación funcional](/es/blog/benchmark-react-ssr) ## Sources [PRNext 0.1.18-alpha on npm](https://www.npmjs.com/package/@thomas.f/prnext/v/0.1.18-alpha) [PRNext 0.1.18-alpha: compatibility and migration](https://github.com/Lorkydey/PRNext/blob/05a9ccd/packages/prnext/docs/ai/compatibility.md) [PRNext 0.1.18-alpha: build and deployment](https://github.com/Lorkydey/PRNext/blob/05a9ccd/packages/prnext/docs/ai/deployment.md) [PRNext 0.1.18-alpha: quickstart](https://github.com/Lorkydey/PRNext/blob/05a9ccd/packages/prnext/docs/ai/quickstart.md) Publicado: 2026-10-30 Modificado: 2026-10-30 Autor: PRNext --- Idioma: es Canonical: https://prnext.dev/es/blog/prnext-nextjs-compatibility-migration Index: https://prnext.dev/llms.txt