Next.js生产环境POST接口返回404但本地环境正常的问题求助

云原生阿岚

2026-4-13

嘿，我来帮你排查下这个棘手的问题！首先看你贴的代码好像没写完，不过先基于现有信息给你梳理几个最可能的排查方向——这类本地正常、生产环境API返回404的情况，大多和路由配置、部署细节脱不了干系：

先确认API路由的文件路径是否合规
Next.js的API路由规则卡得很严：如果用的是Pages Router，文件必须放在pages/api目录下，比如你的接口文件得是pages/api/send-email.js这种；要是用App Router，就得放在app/api/[路由名]/route.js里，比如app/api/send-email/route.js。生产环境部署时，平台会严格按这个路径识别API，哪怕文件名拼错一个字母，都会直接返回404，先仔细核对下路径和文件名！
检查请求的URL是否正确
本地开发时你可能习惯用http://localhost:3000/api/send-email，但到了生产环境，有没有把完整域名加上？比如是不是应该请求https://你的生产域名/api/send-email？很多人容易漏掉/api这个关键前缀，直接请求根路径下的接口，自然会触发404。
查看部署平台的日志和路由识别情况
如果你用Vercel、Netlify这类平台部署，先去翻下部署日志。比如Vercel在部署完成后会列出所有识别到的API路由，你可以确认下你的POST接口有没有出现在列表里。要是平台没识别到你的API文件，那肯定会返回404。另外像Netlify这类平台，需要在netlify.toml里配置函数目录，要是漏了这个配置也会出问题。
环境变量和代码完整性排查
你代码里用到了process.env.EMAIL_USER，生产环境有没有正确配置这个环境变量？虽然这直接导致的是发邮件失败，但如果因为环境变量缺失让代码抛出未捕获的错误，也可能间接让接口返回异常（不过这个概率比路由问题低）。另外你贴的代码没写完，比如auth对象里的pass字段是不是没补充？还有POST函数最后有没有正确返回响应？比如App Router要返回NextResponse.json()，Pages Router要调用res.status(200).json()，要是没正确返回响应，生产环境可能会因为处理异常返回404。

给你补全一个完整的示例代码（App Router版本），你可以参考下：

import nodemailer from "nodemailer";
import { NextResponse } from "next/server";

export async function POST(req) {
  try {
    const { name, email, subject, message } = await req.json();

    const transporter = nodemailer.createTransport({
      service: "gmail",
      auth: {
        user: process.env.EMAIL_USER,
        pass: process.env.EMAIL_PASS, // 这里要填Gmail的应用专用密码，不是你的登录密码
      },
    });

    const mailOptions = {
      from: process.env.EMAIL_USER,
      to: "你的目标收件邮箱地址",
      subject: `${subject} - 来自${name}的留言`,
      text: `发件人邮箱：${email}\n\n留言内容：\n${message}`,
    };

    await transporter.sendMail(mailOptions);

    return NextResponse.json({ success: true, message: "邮件发送成功" }, { status: 200 });
  } catch (error) {
    console.error("邮件发送失败：", error);
    return NextResponse.json({ success: false, error: "邮件发送失败" }, { status: 500 });
  }
}

最后给你个优先级建议：先查路由路径和请求URL，这两个是最常见的触发原因，再去看部署日志，最后排查代码和环境变量！

备注：内容来源于stack exchange，提问作者Akshay Kolhe