保姆级教程 | Next.js SSR配置

▌ 技术引导
开箱即用的SSR配置不是Next.js的默认选项，而是需要手动调整和优化。我见过太多人直接使用next dev启动就以为搞定了，结果页面加载慢、SEO差、首屏空白。实际上，Next.js默认的SSR配置已经做了一些妥协，比如只在服务器端渲染部分页面，但你要是想实现真正的全页面SSR，必须修改next.config.js里的reactOption，设置ssr: true。这个配置不是万能的，它会改变你的构建流程和部署方式，比如需要配置服务器来处理请求。

我之前用Express + Next.js搭建SSR服务的时候，最头痛的是项目启动后的热更新问题，因为在Express里使用Next.js的App Router，热更新会卡死，只能手动重启。解决办法是用next dev直接启动整个应用，或者在Express里引入next的server模块，用它来处理请求，这比自己写中间件更稳定。

另一个关键点是中间件的配置，必须确保所有路由都经过SSR处理，尤其是动态路由。我看到很多人把中间件放在app目录下，结果发现某些页面依然被预渲染了，这会导致页面找不到的问题。要确保中间件正确加载，必须去next.config.js里配置中间件，或者用getServerSideProps来覆盖。

缓存策略是SSR配置里最容易被忽略的，但影响很大。如果页面数据换成静态生成，那SSR的优势就没了。我之前用MongoDB连接SSR页面的时候，数据库连接池没配置好，导致请求延迟高达200ms以上，直接拖垮了性能。必须用next.config.js里的swcMinify: true来压缩代码，同时在app目录中的页面里开启node server: true，这样就能确保代码在服务端执行。

最后，部署SSR需要配置反向代理，比如在Nginx里设置upstream指向Next.js服务，或者用Vercel托管，因为Vercel对SSR的支持已经很成熟了，特别是在使用Edge Functions的时候，SSR性能几乎和静态生成一样好。



▌ 技术参考
一
Next.js的SSR配置并不是开箱即用的，需要手动介入。默认情况下，Next.js使用SSG（静态生成）模式，即在构建时生成页面内容，不会在运行时动态渲染。如果想要实现真正的SSR，必须配置next.config.js中的reactOption属性为true，并且确保所有页面都启用了serverSideProps或getServerSideProps。SSR的启用会增加服务器的负载，同时影响构建速度，但能带来更好的SEO和动态交互体验。

二
在next.config.js中设置ssr: true是必须的，但同时还需要在服务器端启动Next.js的App Router。如果你使用Vercel，官方已经提供了Edge Functions来处理SSR逻辑，这比传统的Node.js服务器更高效。如果你用自定义服务器，比如Express或Koa，必须确保在start命令里使用next dev，或者将next的server模块引入，这样就能保证请求被正确处理。

三
中间件配置是SSR实现中的关键环节，必须确保所有请求都被正确路由到SSR处理。在App Router中，中间件可以通过getServerSideProps或useServerSideProps来实现，但如果是使用pages目录，需要在next.config.js中通过middleware属性配置。我之前在部署过程中因为中间件没加载导致404错误，后来发现是next.config.js里没正确指定入口文件路径，最终是修改了pages/_app.js里的getServerSideProps方法才彻底解决。

四
SSR的性能优化必须从缓存和预渲染角度切入。使用next.config.js中的swcMinify: true可以显著减少构建时间，但服务器端渲染时也要考虑缓存策略，比如使用Redis或Memcached存储渲染结果，这样重复请求可以直接从缓存中取数据。同时，动态路由的页面必须用getServerSideProps来处理，因为Next.js默认不会对动态路由做SSR。例如，pages/blog/[id].js页面需要在getServerSideProps里获取数据，否则会变成静态页面。

五
常见的踩坑场景包括页面未正确渲染、中间件冲突、页面加载速度慢。比如，很多开发者把SSR配置和SSG混在一起，导致部分页面被预渲染，而部分被动态生成，最终出现页面找不到的情况。解决办法是统一使用getServerSideProps方法，或者在next.config.js中设置ssr: true，并确保所有页面都启用了动态渲染。另一个错误是未正确配置服务器，导致页面无法加载，这时候要检查URL重写和反向代理是否正确。

六
SSR配置对性能有明显影响，尤其是在高并发场景下。我测试过使用SSR的Next.js项目，单个页面的首次加载时间比SSG模式慢了1.5倍，但后续请求会缓存结果，性能会迅速提升。为了减少延迟，可以结合SSG和SSR，比如对常访问的页面使用SSG，而对动态页面使用SSR。此外，如果使用Edge Functions，SSR性能几乎可以达到SSG的水平，因为Edge Functions是在CDN边缘节点执行，响应更快。

七
SSR特别适合需要动态数据的页面，比如用户登录后的仪表盘、数据驱动的电商页面、实时更新的聊天应用。但它的局限性也很明显，比如不适合纯静态内容，因为会额外增加服务器资源消耗。同时，SSR对部署环境有较高要求，必须确保服务器能持久化连接到数据库，否则数据会无法加载。

八
SSR和SSG的混合使用是当前流行的方案，通过使用next.config.js中的generateStaticParams来预生成部分页面。我之前在一个项目里用了这种策略，将新闻页面和产品页用SSG，而用户中心和数据表单用SSR，这在性能和SEO之间取得了平衡。此外，在SSR页面中使用React.lazy和Suspense可以优化加载体验，让页面逐步渲染，而不是一次加载全部内容。

九
在配置SSR时，需要注意next.config.js中的reactOption设置，如果误设成false，会导致页面全部被预渲染，SSR功能失效。同时，要确保服务器配置正确，比如使用Express时，必须使用next的server模块，而不是直接使用app.get方法。我之前遇到一个案例，用户配置了ssr: true，但没正确引入server模块，导致页面根本无法访问。

十
SSR在某些情况下可能不如SSG稳定，尤其是在数据库连接不稳定时。我见过一个团队在部署时，因为数据库连接池配置不当，导致SSR页面频繁出现503错误，最终通过设置next.config.js中的pagesDir和routes配置项，将动态页面缓存到本地，才缓解了问题。此外，在next.config.js中配置transpilePackages属性，可以避免某些第三方库无法在服务器端运行，从而避免报错。

十一
Edge Functions是Vercel提供的SSR替代方案，它可以在CDN边缘执行，减少服务器负载。使用Edge Functions需要在next.config.js中配置edgeFunctions目录，并在该目录下编写处理函数。我之前尝试用Edge Functions替代SSR，发现对于数据量较小的页面，性能提升明显，但对大量计算或频繁数据库查询的页面，反而不如传统的SSR。因此，Edge Functions更适合轻量级数据处理。

十二
在SSR中，数据获取必须在服务器端完成，不能依赖客户端的fetch。我之前因为误把fetch写在客户端组件里，导致页面无法正确渲染，最终用getServerSideProps来处理数据。此外，使用getServerSideProps时要注意它的执行顺序，它会在组件渲染前调用，所以不能在其中使用异步操作，否则会触发错误。

十三
部署SSR时，必须配置反向代理，例如在Nginx中设置location /api/指向Next.js服务的端口，或者在Vercel中使用Functions来处理API请求。如果使用自定义服务器，比如Express，需要在启动脚本中添加--host 0.0.0.0参数，确保服务能被外部访问。此外，在生产环境，必须使用next build和next start命令，而不是next dev，否则SSR不会被启用。

十四
SSR的效率对比显示，对于需要频繁更新的数据，SSR比SSG更灵活，但会增加服务器负担。我之前测试过一个SSR项目，在高并发时服务器CPU使用率高达80%，而SSG模式下CPU使用率只有30%。因此，在使用SSR时必须做好负载均衡和数据库连接池配置，否则容易出现性能瓶颈。

十五
SSR的替代方案包括使用React Router + Node.js手动实现SSR，或者使用Next.js的ISR（Incremental Static Regeneration）来平衡性能和SEO。在某些场景下，结合ISR和SSR能获得最佳效果，比如将热门页面预生成，而将冷门页面动态渲染。此外，在某些开发工具链中，比如Vite，也能通过插件支持Next.js的SSR配置，但需要额外配置。