NextJS中将不匹配正则的页面转发至Laravel后端的方案

需求回顾 #

NextJS负责处理以下路由，其余所有路径转发至Laravel后端：

• 根路径 /
• /node/[任意数字]、/way/[任意数字]、/relation/[任意数字]
• 精确路径 /install

问题分析 #

你之前的两种Rewrite配置都存在正则逻辑问题：

1. 第一种配置'/((?!node|way|relation|install):path*)'：
   把NextJS的:path*占位符嵌套在负向预查的括号内，导致正则解析异常，无法匹配任何需要转发的路径，触发NextJS 404。
2. 第二种配置'/((?!node|way|relation|install)):path*'：
   负向预查是零宽度断言（仅匹配位置，不捕获字符），导致:path*只能捕获预查位置后的剩余字符，出现仅转发最后一个字符的情况。

正确的Rewrite配置 #

使用精确的负向预查正则，配合捕获组完整转发路径：

/** @type {import('next').NextConfig} */
const nextConfig = {
  rewrites: () => {
    return [
      {
        // 匹配所有非NextJS负责的路径
        source: '/((?!node/|way/|relation/|install|$).*)',
        // 转发完整路径到Laravel后端
        destination: 'http://pages.example.com/$1',
      },
    ];
  },
};

module.exports = nextConfig;

配置说明 #

• (?!node/|way/|relation/|install|$)：负向预查，确保路径不会是以下情况：
  • 以node/、way/、relation/开头（匹配NextJS的动态路由）
  • 精确等于/install
  • 根路径/（$匹配路径结尾）
• (.*)：捕获组，完整获取需要转发的路径部分，通过$1在destination中引用，保证路径完整转发。

验证场景 #

• 访问/、/node/123456、/install：由NextJS正常处理
• 访问/bar、/foo/abc：完整转发至http://pages.example.com/bar、http://pages.example.com/foo/abc
• 访问/node/abc：NextJS路由代码会返回404（符合你的业务逻辑）

为什么不用Fallback Rewrite？ #

你提到的Fallback模式无效，是因为NextJS会优先匹配自身路由，当你的路由代码返回notFound()时，会直接触发NextJS的404页面，不会进入Fallback转发流程。因此必须用精确的Rewrite规则，提前匹配需要转发的路径。

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