Next.js13 rewrites配置遇重定向而非改写（特定路径词触发）

核心原因推测 #

1. 本地路由冲突 #

Next.js的路由匹配优先级为本地路由（App Router/Pages Router中的文件/目录） > Rewrites规则。如果项目中存在app/board、pages/board、app/collection或pages/collection这类路由目录/文件，Next.js会优先匹配本地路由，而非执行代理改写，进而触发内部重定向逻辑，导致你看到的异常。

2. 目标服务器主动重定向 #

你的rewrite目标地址是https://board.xxx，如果该服务器对请求返回3xx重定向响应，Next.js的rewrite代理会将这个重定向转发给客户端。浏览器处理跨域重定向时，不会自动携带自定义请求头（比如Authorization），这会导致后续请求丢失头信息报错，同时伴随Next.js内部调试请求（_nextjs_original-stack-frame）。

3. 中间件或第三方依赖拦截 #

如果项目配置了middleware.ts，或安装了路由相关第三方依赖（如CMS插件、路由守卫工具），这些工具可能对/board、/collection这类路径进行拦截或重定向，覆盖了你的rewrites规则。

对应解决方法 #

排查本地路由冲突 #

• 检查项目的app/和pages/目录，确认是否存在与board、collection同名的文件夹或文件；
• 如果存在，删除或重命名这些路由资源，确保rewrites规则能被正常匹配。

验证目标服务器响应 #

• 使用Postman或curl直接请求https://board.xxx/popup/popup，查看响应是否包含3xx重定向；
• 如果目标服务器确实返回重定向，可调整目标服务器配置（取消不必要的重定向），或在Next.js中通过API路由手动代理请求，在服务器端处理重定向逻辑，避免客户端跳转丢失请求头：

// app/api/board/[...path]/route.ts
export async function GET(request: Request) {
  const path = request.url.split('/api/board/')[1];
  const targetUrl = `https://board.${process.env.NEXT_PUBLIC_URL_DOMAIN}/${path}`;
  
  const res = await fetch(targetUrl, {
    headers: {
      Authorization: request.headers.get('Authorization') || '',
      // 复制其他必要请求头
    },
    redirect: 'follow' // 在服务器端跟随重定向
  });
  
  return new Response(res.body, {
    status: res.status,
    headers: res.headers
  });
}

检查中间件与第三方依赖 #

• 查看middleware.ts文件，确认是否存在针对/board、/collection路径的拦截或重定向逻辑，如有则调整规则；
• 排查项目依赖，确认是否有路由相关插件占用了这些路径，参考插件文档修改配置或更换路径。

额外验证步骤 #

• 在next.config.js中给rewrites规则添加debug: true，查看Next.js路由匹配日志，确认规则是否被触发：

rewrites: async () => {
  return [
    {
      source: '/board/:path*',
      destination: `https://board.${process.env.NEXT_PUBLIC_URL_DOMAIN}/:path*`,
      debug: true
    }
  ]
}

• 启动项目后查看终端日志，确认/board/xxx请求是否匹配到了rewrite规则。

内容的提问来源于stack exchange，提问作者김경한