Next.js 14 中,可以在构建时生成的页面适合考虑静态导出;依赖请求时服务端功能的项目,应选择支持对应能力的运行环境。先看应用功能,再确认主机能运行哪一种产物,可以减少购买后返工。
改配置前先检查功能
Next.js 14 通过配置 output: 'export' 启用静态导出,构建生成 out 目录。依赖请求的路由处理、Cookie、中间件等运行时功能存在官方列出的限制;默认图片优化也需要为静态导出调整方案。应对照项目实际安装版本的文档逐项核查,不能认为导出后所有框架功能都还在。
构建以后检查什么
在独立工作副本里执行项目原有生产构建。适合静态导出时,确认预期页面和资源都在产物里。直接打开内页、刷新内页,再测试页面间跳转;服务器的文件与 URL 规则要匹配输出布局。
- 首页成功只是第一步,必须不经过首页直接访问一个内页。
- 测试真实表单或接口动作,以及它依赖的外部服务。
- 检查正式域名或子目录下的图片、脚本和样式路径。
- 不要把本地环境变量文件复制到公开产物目录。
哪些情况保留运行环境
项目依赖无法静态导出的服务端行为时,应保留运行环境部署。交接时写清 Node.js 要求、构建命令、启动命令和持久数据。VPS 能承载持续运行的进程,进程守护、域名转发和 HTTPS 仍需要配置。
购买前准备部署需求说明。如果采用 IIS/iisnode 路线,再按IIS Node.js 指南操作;这套流程不适用于 Linux。
本文范围是 Next.js 14。其他主版本应先核对对应版本的部署文档,再修改正在工作的版本。