Strapi调用/forgot-password密码找回接口返回400错误如何排查

需优先检查的配置项 #

• 邮件发送插件配置：Strapi的forgot-password接口调用成功后会自动触发找回密码邮件发送，如果没有配置邮件发送插件（如strapi-provider-email-nodemailer），接口会因为邮件发送流程超时持续处于pending状态，最终抛出400错误。优先检查对应版本的邮件配置文件：Strapi v4检查config/plugins.js，Strapi v3检查config/email.js，确认SMTP地址、端口、授权码、发件人地址等参数是否完整正确，可先单独测试邮件发送功能是否可用，排除该环节问题。
• 请求参数与请求头校验：确认请求头Content-Type配置为application/json，同时检查传入的email参数是否符合标准邮箱格式，不存在空值、特殊字符未转义的情况。Strapi内置的参数校验规则触发后也会返回400错误，部分异常捕获配置不完善的场景下会先出现超时表象。
• 跨域配置：如果前端调用地址和Strapi服务的域名、端口不一致，检查config/middlewares.js中的CORS配置是否将前端域名加入允许列表，跨域配置缺失时部分浏览器会卡住预检请求，最终返回400类错误。
• 服务地址环境变量：确认Strapi服务的SERVER_URL（或PUBLIC_URL）环境变量配置正确，找回密码逻辑中会调用该变量生成密码重置链接，变量缺失或格式错误会导致接口逻辑执行卡住。

同类问题说明 #

该报错是Strapi密码找回功能的高频踩坑点，绝大多数同类问题都是由邮件插件未配置或配置错误导致的，完成邮件配置并测试单发邮件正常后，再调用该接口基本可解决问题。

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