为什么 Next.js 中间件会多次运行？

Question

我使用创建了一个新的Next.js。npx create-next-app@latest --typescript安装后（版本为13.3.4），在不更改任何文件的情况下，我在文件夹middleware.ts中添加了一个新文件src，并且只放置了这段代码：

import type { NextRequest } from "next/server";
import { NextResponse } from "next/server";

export function middleware(request: NextRequest) {
  console.log("request", JSON.stringify(request));
  return NextResponse.next();
}

控制台日志被多次点击。我想应该是一次吧？对于这个新的 Next.js 安装，我需要做任何配置吗？

注意：我将在中间件中执行一些 cookie 逻辑以进行身份​​验证。截屏：

Answer 1

这是正常的，因为middleware默认情况下，a 会针对每个请求运行，包括获取 JavaScritp、CSS 和图像文件等资源的请求。正如您可以在文档中阅读的那样：

将为项目中的每个路由调用中间件。以下是执行顺序：

1. headers从next.config.js
2. redirects从next.config.js
3. 中间件（rewrites、redirects等）
4. beforeFiles（rewrites） 从next.config.js
5. 文件系统路由（public/、_next/static/、pages等）
6. afterFiles（rewrites） 从next.config.js
7. 动态路由 ( /blog/[slug])
8. fallback（rewrites） 从next.config.js

如果添加console.log(request.nextUrl.pathname)，您将看到它运行的不同路径。要让它仅对某些路径执行，您需要使用条件语句或matcher配置，如下所示：

// middleware.ts

import type { NextRequest } from "next/server";
import { NextResponse } from "next/server";

export function middleware(request: NextRequest) {
  console.log("Request for : ", request.nextUrl.pathname);
  return NextResponse.next();
}

export const config = {
  // The above middleware would only run for the "/" path
  matcher: '/',
}

另一种经常使用的匹配模式是：

// middleware.ts

import type { NextRequest } from "next/server";
import { NextResponse } from "next/server";

export function middleware(request: NextRequest) {
  console.log("Request for : ", request.nextUrl.pathname);
  return NextResponse.next();
}

export const config = {
  matcher: [
    /*
     * Match all request paths except for the ones starting with:
     * - api (API routes)
     * - _next/static (static files)
     * - _next/image (image optimization files)
     * - favicon.ico (favicon file)
     */
    '/((?!api|_next/static|_next/image|favicon.ico).*)',
  ],
}