使用NextResponse调用API出现500内部服务器错误问题排查

你的代码出现500内部服务器错误的核心原因是异步操作的返回值没有被正确传递给Next.js路由处理函数。虽然你在then代码块里返回了NextResponse.json，但外层的POST函数没有返回axios的Promise链，导致Next.js无法获取到你期望的响应，最终返回默认的500错误。

修复方案 #

方案1：返回axios的Promise链 #

在axios.post前添加return，让POST函数等待异步操作完成并传递响应结果：

export async function POST(request: NextRequest) {
  let body = await request.json();
  console.log(body);
  if (process.env.URL_FILE_SERVICE_CREATE_CATEGORY) {
    // 添加return返回Promise链
    return axios.post(process.env.URL_FILE_SERVICE_CREATE_CATEGORY)
      .then(response => {
        if (response.status === 202) {
          return NextResponse.json({ hello: 'Next.js' })
        }
        // 补充非202状态的响应返回
        return NextResponse.json({ message: "Unexpected status" }, { status: 400 });
      })
      .catch(err => {
        if (err.response?.status === 409) {
          return NextResponse.json({ message: "conflict" }, { status: 409 });
        } else {
          return NextResponse.json({ message: "Error" }, { status: 500 });
        }
      });
  }
  // 补充环境变量不存在的响应返回
  return NextResponse.json({ message: "Service URL not configured" }, { status: 500 });
}

方案2：改用async/await语法（更推荐） #

避免回调嵌套，代码逻辑更清晰，也更容易处理所有分支的返回值：

export async function POST(request: NextRequest) {
  let body = await request.json();
  console.log(body);
  
  const serviceUrl = process.env.URL_FILE_SERVICE_CREATE_CATEGORY;
  if (!serviceUrl) {
    return NextResponse.json({ message: "Service URL not configured" }, { status: 500 });
  }

  try {
    const response = await axios.post(serviceUrl);
    if (response.status === 202) {
      return NextResponse.json({ hello: 'Next.js' });
    }
    return NextResponse.json({ message: "Unexpected status" }, { status: 400 });
  } catch (err) {
    if (axios.isAxiosError(err) && err.response?.status === 409) {
      return NextResponse.json({ message: "conflict" }, { status: 409 });
    }
    return NextResponse.json({ message: "Error" }, { status: 500 });
  }
}

额外注意事项 #

• 确保所有代码分支都返回NextResponse：包括环境变量不存在、响应状态不符合预期的情况，避免函数无返回值导致的服务器错误。
• 在catch块中使用axios.isAxiosError判断错误类型，防止err.response为undefined时出现报错。

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