NextJS 10 URL大小写敏感问题：生产环境实现传入URL小写化方案

首选方案：Edge Middleware 前置重定向（兼容NextJS 12+版本，完全适配getStaticPaths与ISR） #

该方案的执行时机在所有路由匹配、静态资源生成、增量再生存取流程之前，不会侵入现有业务代码，也不会打断getStaticPaths和ISR的正常工作流。
具体实现步骤：

• 在项目根目录创建middleware.ts（TypeScript项目）或middleware.js（JavaScript项目）
• 写入如下核心逻辑：

  import { NextResponse } from 'next/server'
  import type { NextRequest } from 'next/server'
  
  export function middleware(request: NextRequest) {
    const url = request.nextUrl.clone()
    const lowercasedPath = url.pathname.toLowerCase()
    // 原路径存在大小写差异时，返回308永久重定向到全小写标准路径
    if (url.pathname !== lowercasedPath) {
      url.pathname = lowercasedPath
      return NextResponse.redirect(url, 308)
    }
  }
  
  // 配置匹配规则，排除NextJS系统路径、静态资源，避免干扰正常资源加载
  export const config = {
    matcher: [
      '/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)',
    ],
  }
  

方案兼容性说明 #

• 重定向逻辑完全前置：你现有项目遵循NextJS路由规范，路由文件采用全小写命名，getStaticPaths返回的路径本身就是全小写格式。当用户被重定向到全小写路径后，请求会正常走原有项目的路由规则，和getStaticPaths收集的静态路径、ISR的增量再生流程完全衔接，不需要修改任何现有页面代码
• 308状态码对SEO友好：会自动将旧的带大写路径的链接权重转移到全小写的标准路径，搜索引擎抓取到重定向后会逐步替换索引里的旧链接，不会长期保留404状态
• 全局覆盖所有大小写变体：不需要单独枚举每一条Google存储的旧链接，任意大小写组合的历史路径都会被自动识别、重定向，完全解决存量链接格式不统一的问题
• 重定向过程会完整保留URL查询参数，不会丢失原链接携带的参数信息

避坑提示 #

• 不要将_next开头的系统路由、public目录下的静态资源加入matcher范围，否则会导致样式、脚本、静态图片加载异常
• 不要使用302临时重定向，308是不改变请求方法的永久重定向，最适合这类URL规范化的场景

低版本适配（NextJS 10~11，无Middleware能力） #

如果还在使用不支持Middleware的旧版本NextJS，可以在自定义服务入口中，在将请求传递给NextJS核心handler之前，加入和上述逻辑完全一致的路径判断、重定向代码，同样不会影响getStaticPaths与ISR的运行。注意自定义服务方案会损失NextJS默认部署的部分优化能力，建议在适配完成后尽快升级到支持Middleware的版本。

不推荐的实现方案 #

• 不要在getStaticPaths中枚举所有大小写组合的路径返回值：历史链接的大小写组合无上限，枚举逻辑会导致构建体积成倍膨胀，完全无法维护
• 不要修改现有动态路由的文件命名规则适配大小写：会打破现有NextJS路由约定，增加后续维护成本

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