Nuxt.js生产环境POST请求nuxt-mail接口404本地运行正常如何解决

问题根因定位 #

首先明确核心前提：nuxt-mail提供的/mail/send是服务端路由，依赖Node环境运行的Nuxt服务端逻辑才能正常响应。
你本地开发时启动的是完整的Nuxt开发服务，包含服务端逻辑，所以接口正常；部署到Netlify后404，90%以上的概率是你用了nuxt generate做纯静态打包部署，纯静态产物只有静态资源文件，Netlify静态托管环境没有运行服务端代码的能力，自然找不到这个服务端接口。

排查&解决步骤 #

第一步：先验证本地生产模式是否正常 #

先在本地执行nuxt build && nuxt start启动生产模式服务，访问/mail/send接口：

• 如果本地生产模式也返回404：检查nuxt.config.js中nuxt-mail的注册配置，确认没有加devOnly: true这类仅开发环境生效的限制，同时确认modules配置中已经正确注册了nuxt-mail模块
• 如果本地生产模式接口正常：问题出在Netlify的部署配置，继续往下看

第二步：根据你的部署模式选择对应解决方案 #

方案1：保留nuxt-mail，切换为SSR模式部署

不要使用nuxt generate做静态打包，改为用nuxt build打包，在Netlify中安装Nuxt适配插件，部署为Node服务，保证服务端中间件逻辑能正常运行。同时要检查Netlify的重定向规则：如果你配置了SPA fallback规则/* /index.html 200，需要在这条规则前面加一行/mail/send 200，避免接口请求被重定向规则拦截。

方案2：保留静态部署，替换发信实现

如果要保留静态站点的优势，直接弃用nuxt-mail的服务端接口，自己写Netlify Function实现发信逻辑：

1. 在项目根目录新建netlify/functions/send-mail.js，用nodemailer等库实现邮件发送逻辑
2. 前端请求地址改成/.netlify/functions/send-mail即可，不需要依赖Nuxt服务端路由

额外检查项 #

确认生产环境的NODE_ENV变量值是否和你配置的逻辑一致，避免baseUrl拼接错误，另外你可以直接把请求地址改为相对路径/mail/send，不需要拼接process.env.baseUrl，避免变量取值错误导致请求地址异常。

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