含义
服务器遇到意外情况，无法完成请求。这是服务器端错误的通用兜底状态码。
常见原因
- 应用代码中未处理的异常或 bug
- 配置错误，例如 .htaccess 有误或缺少环境变量
- 数据库或依赖故障没有映射到更合适的状态码
解决方法
客户端或访问者
稍后重试；如果持续出现，报告发生时间以及响应中的请求 ID。
网站或 API 的维护者
查看应用和服务器错误日志，修复异常；原因明确时返回更具体的状态码（502、503、504）。
响应示例
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
}规范
常见问题
› 如何找到 500 的原因？
查看请求发生时服务器或应用错误日志中的堆栈信息；只在开发环境开启调试模式。
› .htaccess 文件会导致 500 吗？
会。.htaccess 中的语法错误或未知指令会让 Apache 返回 500。