六一儿童节快乐！！

如果希望在 Next.js 的服务端组件（Server Component）中获取当前请求的路径（pathname），但又不想使用 API 路由或客户端组件（Client Component），可以通过使用 Middleware 来实现。

使用 Middleware 获取当前路径

可以在 Next.js 的 Middleware 中拦截请求，并将当前路径添加到请求头中，然后在服务端组件中读取该请求头，从而获取当前路径。

1. 创建 Middleware

在项目的根目录下创建一个 middleware.ts 文件：

// middleware.ts
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  const requestHeaders = new Headers(request.headers);
  requestHeaders.set('x-current-path', request.nextUrl.pathname);

  return NextResponse.next({
    request: {
      headers: requestHeaders,
    },
  });
}

export const config = {
  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],
};

上述 Middleware 会将当前请求的路径添加到请求头中的 x-current-path 字段。(Medium)

2. 在服务端组件中读取路径

在服务端组件中，可以使用 headers() 方法读取请求头，从而获取当前路径：(propelauth.com)

import { headers } from 'next/headers';
export default async function Getsuffix(layer : number):Promise<string>{
  const headerList = await headers();
  const pathname = headerList.get('x-current-path') || '/';
  // 解析路径后缀
  const segments = pathname.split('/');
  const titleSuffix = segments[layer] || '';
  return (
    titleSuffix
  );
}

在构建中大型的 Next.js 应用时，我们往往需要在请求进入应用之前做一些预处理，比如用户认证、国际化设置、重定向等。Next.js 从 12 版本开始支持 Middleware，它运行于边缘节点，可以在请求到达页面组件之前拦截和处理请求。

本文将逐步讲解如何在 Next.js 中实现多个中间件的逻辑，并且保持代码的清晰与模块化。

一、Middleware 的基础概念

在 Next.js 中，你只需要在项目根目录创建一个名为 middleware.ts 或 middleware.js 的文件即可启用 Middleware。这个文件会自动被 Next.js 识别，不需要额外配置。

一个最基础的中间件看起来如下：

// middleware.ts
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  return NextResponse.next();
}

该中间件会对所有请求生效，并简单地允许请求继续往下走。

二、实现多个中间件逻辑的需求

假设我们现在有两个独立的功能需要处理：

1. authMiddleware: 用于判断用户是否登录，未登录则重定向到 /login
2. i18nMiddleware: 用于设置用户语言偏好

我们希望它们都在每个请求前依次执行。如何做到这点呢？

三、模块化中间件逻辑

为了保持代码整洁，我们将每个功能模块拆分到单独文件中：

middlewares/authMiddleware.ts

import { NextRequest, NextResponse } from 'next/server';

export function authMiddleware(request: NextRequest): NextResponse | void {
  const isAuthenticated = true; // 示例逻辑
  if (!isAuthenticated) {
    return NextResponse.redirect(new URL('/login', request.url));
  }
}

middlewares/i18nMiddleware.ts

import { NextRequest, NextResponse } from 'next/server';

export function i18nMiddleware(request: NextRequest): NextResponse | void {
  const locale = request.headers.get('accept-language')?.split(',')[0] || 'en';
  request.headers.set('x-locale', locale);
}

四、在 middleware.ts 中组合这些中间件

// middleware.ts
import { NextRequest, NextResponse } from 'next/server';
import { authMiddleware } from './middlewares/authMiddleware';
import { i18nMiddleware } from './middlewares/i18nMiddleware';

export function middleware(request: NextRequest): NextResponse {
  const authResponse = authMiddleware(request);
  if (authResponse) return authResponse;

  const i18nResponse = i18nMiddleware(request);
  if (i18nResponse) return i18nResponse;

  return NextResponse.next();
}

export const config = {
  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],
};

我们依次执行每一个中间件函数：

• 如果某个中间件返回了 NextResponse，表示它希望拦截或终止请求流程，例如重定向；
• 如果返回 undefined，表示它只是修改了请求状态或头部，不影响流程，继续执行下一个。

这种模式非常直观，也方便调试和扩展。

五、为什么使用 return 会中止后续中间件？

很多开发者初看可能会疑惑：

"既然我要执行多个中间件，为什么用 return 会跳过后面的逻辑？"

这是因为我们在实现“链式中间件”的处理逻辑——每个中间件有权决定是否终止请求流程。

举例来说，用户未认证时我们希望立即重定向到 /login，那么其他逻辑（比如设置语言、加载用户数据）就不需要再执行。

这种设计思路与很多后端框架如 Express.js 的中间件模型类似。

六、总结

Next.js 的 Middleware 是一个强大且灵活的工具，允许你在请求生命周期的早期阶段拦截和处理逻辑。

• 你只需一个 middleware.ts 文件
• 将每个中间件功能模块化，方便复用与测试
• 在主中间件函数中按顺序调用它们，并根据是否返回 NextResponse 控制流程

这样的设计既保持了结构的清晰，又便于日后扩展。如果你在构建应用时需要实现用户权限、国际化、AB 测试等功能，Middleware 是一个值得深入使用的机制。

希望本文对你理解和使用 Next.js Middleware 有所帮助！

五一小长假快乐！

在 Go 语言中，flag 是一个用于解析命令行参数的标准库。通过这个库，你可以很方便地从命令行中获取用户传入的参数，比如字符串、整数、布尔值等。

主要用途：

处理命令行参数，例如：

go run main.go -name=Tom -age=25 -debug=true

基本使用示例：

package main

import (
    "flag"
    "fmt"
)

func main() {
    // 定义命令行参数
    name := flag.String("name", "default", "请输入用户名")
    age := flag.Int("age", 18, "请输入年龄")
    debug := flag.Bool("debug", false, "是否开启调试模式")

    // 解析命令行参数
    flag.Parse()

    fmt.Println("name:", *name)
    fmt.Println("age:", *age)
    fmt.Println("debug:", *debug)
}

常用函数：

需要注意，flag 默认只支持 -key=value 或 -key value 的形式，不支持 --key 的双横线写法（这在某些 CLI 工具中是常见的）。

使用上面的写法获取到的变量是一个指针，所以在访问的时候如果要访问对应的值需要在变量之前加一个*号

如果想要直接得到变量也可以是用下面这种写法

var name string
flag.StringVar(&name, "name", "default", "请输入用户名")

这种写法是自己定义一个变量，然后将它的地址传进去

flag 后面的提示文字（也叫 usage 或说明文本）会在以下几种情况下自动显示：

1. 用户执行程序时传入了 h 或 -help

这是最常见的触发方式，flag 包会自动帮你注册 -h 和 --help 参数，触发时会显示所有参数的说明信息。例如：

go run main.go -h

输出会像这样：

Usage of /tmp/go-build.../main:
  -age int
        请输入年龄 (default 18)
  -debug
        是否开启调试模式 (default false)
  -name string
        请输入用户名 (default "default")

2. 程序中手动调用 flag.Usage()

你可以在代码里手动触发帮助信息显示，例如参数验证失败时：

if *name == "" {
    fmt.Println("name 参数不能为空")
    flag.Usage()
    os.Exit(1)
}

3. 覆盖默认的帮助输出内容（可选）

你也可以自定义 flag.Usage 的行为，比如美化输出：

flag.Usage = func() {
    fmt.Println("用法说明：")
    fmt.Println("  -name string    请输入用户名 (默认值：default)")
    fmt.Println("  -age int        请输入年龄 (默认值：18)")
    fmt.Println("  -debug          是否开启调试模式 (默认值：false)")
}

总结一下：