Next.js 13 App Router 中的 API 路由不再支持 req.query，必须使用 request.nextUrl.searchParams 解析 URL 查询参数，否则会因 req.query is undefined 报错。

next.js 13 api 路由中正确获取查询参数的方法：next.js 13 app router 中的 api 路由不再支持 `req.query`，必须使用 `request.nexturl.searchparams` 解析 url 查询参数，否则会因 `req.query is undefined` 报错。

在 Next.js 13 的 App Router 中，API 路由（位于 app/api/.../route.ts/js）已彻底重构为基于 Web Request/Response 标准的函数式路由处理器，不再兼容 Pages Router 风格的 (req, res) => {} 处理器签名。你当前代码中使用的 req.query 是 Pages Router 的遗留写法，在 App Router 下 req 对象根本不存在 query 属性——正如控制台日志所示，查询参数实际封装在 request.nextUrl.searchParams（一个标准 URLSearchParams 实例）中。

✅ 正确做法：使用命名导出的 HTTP 方法处理器（如 GET、POST），并通过 request.nextUrl.searchParams 获取参数：

Wjs Localizing Video

用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...

下载

// app/api/events/route.ts
import { NextRequest, NextResponse } from 'next/server';
import Event from '@models/Event';
import { connectToMongoDB } from '@utils/database/connectToMongoDB';

export async function GET(request: NextRequest) {
  // ✅ 正确获取查询参数
  const searchParams = request.nextUrl.searchParams;
  const filterBy = searchParams.get('filterBy'); // string | null
  const status = searchParams.get('status');      // string | null

  // 安全解构（避免 null/undefined 报错）
  const filters = Object.fromEntries(
    Array.from(searchParams.entries()).filter(([key]) => key !== 'filterBy')
  );

  try {
    await connectToMongoDB();
    const events = await Event.find(filterBy && status ? { [filterBy]: status } : {});
    return NextResponse.json({ data: events }, { status: 200 });
  } catch (error) {
    return NextResponse.json({ error: 'Failed to fetch events' }, { status: 500 });
  }
}

⚠️ 注意事项：

• 禁止使用默认导出或 (req, res) 签名：App Router 要求显式导出 GET、POST 等方法，否则路由无法注册；
• searchParams.get() 返回 string | null：务必做空值判断，或使用可选链/空值合并（如 filterBy ?? 'all'）；
• 批量提取所有参数：若需完整 query 对象，可用 Object.fromEntries(searchParams.entries())，但注意它会包含 filterBy，需手动过滤；
• 客户端调用保持不变：fetch('/api/events?filterBy=status&status=Live') 完全兼容，无需修改。

? 小贴士：若需类型安全，可配合 Zod 或自定义类型守卫校验参数格式；对于复杂过滤逻辑，建议将参数解析与业务逻辑分离，提升可测试性与可维护性。