在 Next.js 13 的 App Router 中，API 路由不再接收 req.query 对象，而是需通过 request.nextUrl.searchParams 获取 URL 查询参数，直接解构 req.query 会导致 undefined 错误。
在 next.js 13 的 app router 中，api 路由不再接收 `req.query` 对象，而是需通过 `request.nexturl.searchparams` 获取 url 查询参数，直接解构 `req.query` 会导致 `undefined` 错误。
Next.js 13 引入了全新的 App Router 架构，其 API 路由（位于 app/api/.../route.ts/js）与旧版 Pages Router 的处理方式有本质区别：不再使用 (req, res) => {} 函数签名，也不再提供 req.query 属性。你当前代码中沿用 Pages Router 的写法（如 export default async (req, res) => {...}），是导致 req.query is undefined 的根本原因。
✅ 正确写法：使用命名导出 + NextRequest
API 路由必须导出标准 HTTP 方法命名函数（如 GET、POST），并接收类型为 NextRequest 的参数。查询参数需通过 request.nextUrl.searchParams 访问——这是一个标准的 URLSearchParams 实例，支持 .get()、.getAll()、.entries() 等方法。
// app/api/events/route.ts
import { NextRequest } 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
// ✅ 解构多个参数（安全写法）
const filters: Record<string, string> = {};
for (const [key, value] of searchParams.entries()) {
if (key !== 'filterBy') {
filters[key] = value;
}
}
// 示例：连接数据库并查询
await connectToMongoDB();
const events = await Event.find(filterBy === 'status' ? { status } : {});
return Response.json({ data: events });
}⚠️ 注意事项
- 不要使用 export default：App Router 的 API 路由不支持默认导出，必须显式导出 GET、POST 等方法。
- searchParams.get() 返回 string | null：务必做空值检查，避免运行时错误；可使用 ?? 或条件判断处理缺失参数。
- 批量提取参数推荐遍历：若需动态过滤（如 ...filters），使用 searchParams.entries() 遍历比手动列出更健壮。
- 客户端调用保持不变：你的 fetch('/api/events?filterBy=status&status=Live') 完全正确，无需修改。
- 类型提示增强可靠性：建议引入 NextRequest 类型（来自 'next/server'），并在开发环境启用 TypeScript，提前捕获类型错误。
? 补充：调试技巧
可在路由中快速打印所有查询参数：
console.log('All query params:', Object.fromEntries(request.nextUrl.searchParams.entries()));
// 输出：{ filterBy: 'status', status: 'Live' }遵循此模式，即可彻底解决 req.query is undefined 问题，并充分利用 App Router 的标准化、类型安全和中间件兼容能力。
