如何在Next.js配置中将根路径/重定向到已设置的basePath？

你遇到的核心问题是：当设置了basePath后，Next.js的redirects/rewrites规则默认会自动附加到basePath前缀下，所以你之前写的source: '/'实际匹配的是/docs/，而非域名根路径的/。

要让根路径的重定向规则直接生效，只需要在redirect配置里添加basePath: false选项——这个参数会告诉Next.js，这条规则不使用basePath作为前缀，直接作用于域名的根路径。

修改后的完整next.config.js配置如下：

module.exports = {
  basePath: '/docs',
  async redirects() {
    return [
      {
        source: '/',
        destination: '/docs',
        basePath: false, // 关键：让规则跳过basePath前缀，直接匹配根路径
        permanent: true, // 可选：设为true返回301永久重定向，false则是302临时重定向
      },
    ];
  },
};

补充说明 #

• 加上basePath: false后，访问域名根路径/时，会直接被重定向到/docs，完全符合你的需求。
• 原有basePath内部的路由规则不受影响：比如之后你添加source: '/test'的redirect规则，依然会匹配/docs/test并重定向到对应路径。
• 测试时重启Next.js应用，确保新配置生效。

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