Next.js静态站点部署到Nginx后路由失效问题详解
使用Next.js静态导出部署到Nginx服务器后，刷新页面时路由失效，跳转回首页，是许多开发者遇到的常见问题。本文将深入探讨这个问题的成因及解决方法。
问题描述
假设您已创建一个Next.js项目，包含一个/test路由，并配置了静态导出：
{
"output": "export"
}
本地开发环境(运行npm run dev)访问localhost:3000/test正常显示。但部署到Nginx后，访问/test却跳转到首页。即使Nginx配置了404跳转到首页：
location / {
try_files $uri $uri/ /index.html;
}
这与Vue.js的history模式不同，后者在类似配置下通常能正常工作。
问题分析
Nginx的try_files指令在静态目录中找不到对应路由的文件时，会回退到index.html。这看似符合预期，因为静态导出可能未生成对应路由的静态文件。然而，根本原因在于Next.js的静态导出机制与客户端路由处理方式的差异。
解决方法
解决此问题，需要从Next.js的配置和Nginx的配置两个方面入手：
-
Next.js
basePath配置: 如果你的Next.js应用部署在子路径下(例如/my-app)，你需要在next.config.js中配置basePath：
module.exports = {
basePath: '/my-app',
}
-
Nginx配置优化: 调整Nginx的
try_files指令，使其更精确地处理路由：
location / {
try_files $uri $uri/ /my-app/index.html; # 如果部署在/my-app下
}
这将确保Nginx在找不到指定路由文件时，正确地指向部署目录下的index.html文件。
-
使用Next.js自带的服务器: 避免直接使用Nginx服务静态文件，建议使用Next.js自带的服务器，并使用Nginx作为反向代理。这样，路由处理由Next.js服务器完成，避免了静态文件匹配的问题。
-
检查生成的静态文件: 确保Next.js的静态导出已正确生成所有必要的路由文件。可以使用
next export命令重新导出，并检查生成的目录结构。
通过以上方法，您可以有效解决Next.js静态导出在Nginx上路由失效的问题，确保您的静态网站能够正确处理所有路由请求。 选择哪种方法取决于您的具体部署环境和需求。 如果可能，建议优先考虑使用Next.js自带的服务器以及反向代理的方式，这能提供更可靠的路由处理。
