Next.js next.config.mjs配置的重定向在Netlify上失效问题排查

核心问题根源 #

你的问题本质是没理清Netlify在Monorepo环境下的路径解析逻辑，以及站点配置的优先级规则：

• Netlify会将你指定的站点基础目录作为所有路径的基准，而非仓库根目录
• 同时在UI和站点本地netlify.toml配置publish路径会引发冲突，导致重定向规则无法被正确读取

分步解决方案 #

1. 修正netlify.toml的publish路径配置
   在apps/web目录下的netlify.toml里，只需要写相对路径，因为Netlify已经把apps/web当作该站点的工作根目录了：

   [build]
     publish = ".next"
     command = "npm run build" # 根据你的包管理工具替换为pnpm/yarn build
   

   不要写全路径apps/web/.next，否则Netlify会基于站点基础目录重复拼接，导致apps/web/apps/web/.next的错误路径。

2. 设置正确的站点基础目录
   登录Netlify后台，找到对应站点的Build & deploy > Continuous deployment > Build settings，将「Base directory」设置为apps/web。这一步是关键，告诉Netlify这个站点的构建根目录是apps/web，而非仓库根目录。

3. 确保Next.js重定向规则被正确生成
   检查你的next.config.mjs重定向配置格式是否正确，示例如下：

   export default {
     async redirects() {
       return [
         {
           source: '/old-page',
           destination: '/new-page',
           permanent: true, // 301永久重定向，false为302临时重定向
         },
       ];
     },
   };
   

   本地执行构建命令后，查看apps/web/.next/routes-manifest.json文件，确认里面包含你配置的重定向规则——Netlify Next.js运行时正是通过这个文件读取重定向规则的。

4. 避免配置冲突
   删除Netlify UI中设置的publish路径，以站点本地netlify.toml的配置为准，防止双重配置导致的规则失效。

额外排查点 #

• 查看Netlify构建日志，搜索routes-manifest或redirect关键词，确认是否有重定向规则被加载的日志信息。如果没有相关日志，说明Next.js构建时未生成规则，或者Netlify未读取到。
• 确认站点启用了Netlify Next.js Runtime（默认启用，可在Build & deploy > Post processing中检查），这是Next.js重定向规则在Netlify生效的必要条件。

内容的提问来源于stack exchange，提问作者curly_brackets