PRNext 和 Next.js：兼容性和迁移指南

#调整版本和先决条件

此版本声明节点 ^22.23.4 || ^24.22.1 || >=26.12.1. 其 React、React DOM 和 React-server-dom-webpack 对等体是 19.3.1. 保持可选的本机依赖项启用：本机组件必须与框架版本匹配。

以下命令使用 npm。如果项目已使用 pnpm 或 Yarn，请保留它们并阅读包中附带的文档。处理分支或隔离副本，保留原始锁定文件。已发布的本机包不需要消费者安装 Rust。

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

#识别需要重点检查的功能

路由约定、服务器组件、操作、导航和样式均属于 PRNext 改编的领域。范围取决于配置和执行的路径。该矩阵标识应用程序检查，而不是为每个功能系列分配通用兼容性。

#申请移民前请阅读计划

通过试运行，您可以查看建议的脚本和依赖项更改。审计还应该识别配置和源冲突。保留一个 next.config.* 或 prnext.config.* 文件；重命名它不会支持未知的 Next.js 选项。

当计划合适时，应用迁移、检查配置和构建。类型检查需要应用程序中的 TypeScript 和 tsconfig。迁移保留来源和 Next.js；公共 next/* 导入可以保留。避免使用 --force 进行全面导入替换或隐藏对等冲突。

npx --no-install prnext migrate
npx --no-install prnext check --json
npx --no-install prnext typecheck
npx --no-install prnext build

#比较来自不同服务器的响应

在可用端口上启动 Next.js 参考，在另一个端口上启动候选端口。 paths.json 包含具体路由的 JSON 数组，例如 ["/"、"/products/demo"、"/api/health"]，替换为应用程序的路径。不要让cookies和秘密进入其中。

比较器检查公共 GET 响应的样本。它不验证请求或遵循重定向。它的时间安排不是一个受控基准。良好的结果仍然需要浏览器检查样式、水合作用、突变和身份验证状态。

npx --no-install prnext migrate --check --against http://127.0.0.1:3000 --candidate http://127.0.0.1:3001 --routes paths.json

#验证使产品发挥作用的旅程

执行登录、注销和业务操作。检查导航、错误、加载状态和 cookie。对于表单，验证存储的结果和响应后显示的状态。 HTTP 状态并不描述整个交互。

添加两个会话的隔离检查：私有响应和缓存数据不得在它们之间交叉。如果您使用私有 Next.js 导入、自定义加载程序或高级路由，请保留测试路径的最小示例。这些依赖关系可能会改变评估。

#功能验证后决定

保留确切的版本、锁定文件、测试用例和任何不兼容性。如果缺少某个功能，请识别 API 和所涉及的场景。精确的限制比总体兼容性百分比更有用。

然后在匹配的资源限制下测量昂贵的路线。保留参考资料，直到候选人符合您的标准。数据库迁移需要有自己的回滚计划；恢复 package.json 不会撤消它们。

根据您的应用程序要求选择 PRNext

功能验证后测量 SSR