Strapi后端Postman请求正常 Next.js前端调用返回500内部服务器错误

最可能的500错误触发原因及修复方法 #

• 错误字段取值导致的运行时异常
  你当前在register.js的非成功分支直接硬编码取data.message[0].messages[0].message，但Strapi不同版本的错误返回结构存在差异，部分错误场景下data.message可能不存在、为空数组，访问不存在的数组索引会直接抛出异常，触发Next.js API路由的500响应。
  修复代码如下：

} else {
  // 增加错误结构兼容判断，避免取值异常
  const statusCode = data.statusCode || 400
  let errMsg = '注册失败，请检查输入参数'
  if (Array.isArray(data.message) && data.message[0]?.messages?.length) {
    errMsg = data.message[0].messages[0].message
  }
  res.status(statusCode).json({ message: errMsg })
}

• 语法错误导致的接口异常
  你贴出的register.js代码最后缺少一层函数闭合的}，如果实际运行的代码也存在该问题，语法错误会直接触发500响应，补上闭合括号即可。
• 错误被清空导致无法定位问题
  上下文register函数中，你设置错误后立刻清空了错误：

setError(data.message)
setError(null) // 这行为多余代码

删除setError(null)即可拿到后端返回的具体错误信息，辅助定位问题。

辅助排查手段 #

1. 在register.js中增加日志打印，查看请求参数和Strapi返回的原始内容：

const { username, email, password } = req.body
// 打印接收的前端参数，确认是否和Postman传参一致
console.log('注册请求参数：', {username, email, password})

const strapiRes = await fetch(`${API_URL}/auth/local/register`, {/* 原有配置 */})
const data = await strapiRes.json()
// 打印Strapi返回的原始内容，查看是否有报错信息
console.log('Strapi返回结果：', data)

启动开发模式后查看终端日志，即可直接定位Strapi侧的具体报错原因。
2. 校验环境变量配置：确认API_URL和登录功能使用的后端地址一致，没有拼写错误、缺少http前缀、端口错误等问题。
3. 检查Strapi用户模型配置：确认是否有额外必填的自定义字段，Postman测试时传了该字段但前端没有传递。

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