Next.js的API端点中如何正确打印调试输出信息

首先明确核心规则：Next.js 所有API路由的处理逻辑都运行在服务端，代码不会下发到浏览器端，因此接口内的打印内容永远不会出现在浏览器审查控制台，正常输出只会出现在运行Next.js服务的终端中。

你之前使用console.log看不到输出，按以下步骤排查解决：

• 先排查基础语法错误：JavaScript/TypeScript 不支持#作为单行注释符（#是Python、Shell等语言的注释语法），如果直接把示例里的# print someting here写进代码会直接触发语法错误，导致接口返回500，打印逻辑根本不会执行。接口内打印直接使用标准console.log即可，参考正确写法：

// Pages Router 写法示例
export default function handler(req, res) {
  // 把需要调试的内容传入console.log，建议放在函数最顶部先确认接口被触发
  console.log("接口触发调试：", req.method, req.url, req.query, req.body)
  // 其余业务逻辑
  res.status(200).json({ code: 0 })
}

// App Router 写法示例，打印逻辑完全一致
export async function GET(req) {
  console.log("App Router接口触发：", req.nextUrl.searchParams)
  return Response.json({ code: 0 })
}

• 确认查看输出的终端正确：本地开发时，必须查看你执行npm run dev（或yarn dev/pnpm dev）启动Next.js服务的那个终端窗口，不要混淆其他项目的终端、独立的命令行窗口。如果是部署到线上的接口，需要到对应部署平台的服务运行日志面板查看输出，本地终端无法获取线上接口的打印内容。
• 确认打印逻辑有被执行到：如果请求路径写错、请求方法不匹配（比如接口只接受POST你发了GET请求）、或者打印语句之前的代码已经抛出错误/提前返回响应，打印就不会执行。可以先在处理函数的第一行写固定字符串的打印，比如console.log("===测试打印===")，先验证请求是否真的进入了当前处理函数。
• 特殊场景排查：如果使用next dev --turbo启动开发环境时偶发日志丢失，可以暂时关闭TurboPack参数重启服务验证；同时检查终端是否开启了日志关键词过滤，把普通级别的log输出屏蔽了。
• 如果需要在浏览器控制台看到调试信息，不要在API路由内写打印逻辑：可以把要调试的内容放到接口响应体里返回，在前端调用接口的业务代码中拿到响应后再调用console.log，这部分代码运行在浏览器端，输出才会显示在浏览器审查控制台。

注意：API路由是服务端运行环境，不要在里面调用window、document等浏览器专属API，会直接抛出运行时错误，中断后续代码执行，导致打印逻辑无法运行。

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