500 Internal Server Error报错

一句话：服务器内部执行失败，常见于代码异常、数据库错误、环境变量缺失或第三方接口失败。

它是什么

500 Internal Server Error表示请求到达服务器后，服务器在处理时出错。它通常不是前端页面问题，而是后端函数、数据库、文件、权限、环境变量或外部API出了异常。排查时要看服务器日志，而不是只看浏览器报错。

适合干什么

• 部署后接口突然失败的人
• 后端API返回500的人
• 调用数据库或第三方API的人
• Vercel、Node.js、Express项目开发者

不适合干什么

• 接口地址写错的404
• 未登录的401
• 权限不足的403
• 单纯CSS或页面布局问题

普通人怎么用

• 打开服务器日志
• 找到报错堆栈第一行
• 确认是哪一个接口出错
• 检查环境变量和数据库连接
• 用最小请求复现问题

进阶用户怎么用

• 给接口增加try/catch和结构化日志
• 区分业务错误和系统错误
• 为第三方接口加超时和重试
• 接入错误监控和告警

常见误区

• 只看前端控制台，不看服务端日志
• 把真实错误直接返回给用户
• 线上缺环境变量但本地正常
• 没有记录请求ID，难以定位

和相似工具的区别

• 500 vs 400：400通常是请求参数有问题，500是服务器处理时出现异常。
• 500 vs Build failed：500是运行时出错，Build failed是构建阶段失败。

入门步骤

• 复现报错
• 查看服务端日志
• 定位接口和堆栈
• 检查环境变量
• 检查数据库和第三方API
• 修复后增加错误处理

推荐工具（第三方）

Vercel Logs、Node.js日志、Sentry、Postman、数据库控制台