一、接口常见返回码分类、含义 简介接口返回码分 HTTP 状态码传输层、业务自定义返回码业务层 两大类下面分开梳理适配面试与日常测试场景。一、HTTP 标准状态码HTTP 协议层面前端 / 网关优先识别1xx 信息类临时响应继续处理1.100 Continue客户端可继续发送请求已收到请求头2.101 Switching Protocols切换协议如 HTTP 升级为 WebSocket2xx 成功类请求正常处理完成200 OK最常用请求成功正常返回业务数据201 Created新建资源成功POST 新增数据场景204 No Content执行成功但无返回内容删除操作常用3xx 重定向类301 Moved Permanently永久重定向旧地址永久迁移至新地址302 Found临时重定向本次访问跳转新地址304 Not Modified资源未修改客户端可直接用本地缓存节省带宽4xx 客户端错误问题出在调用方400 Bad Request请求参数格式错误、参数缺失、JSON 解析失败401 Unauthorized未登录、Token 缺失 / 过期需要身份认证403 Forbidden已登录但权限不足禁止访问该接口404 Not Found接口地址写错、资源不存在405 Method Not Allowed请求方法错误接口只接收 POST却用 GET 调用408 Request Timeout客户端请求超时429 Too Many Requests请求频次过高触发限流5xx 服务端错误问题出在后端服务**500 Internal Server Error**后端代码异常、空指针、SQL 报错等未知服务故障502 Bad Gateway网关 / 代理拿到后端无效响应服务宕机、端口不通503 Service Unavailable服务暂时不可用比如停机维护、过载熔断504 Gateway Timeout网关等待后端响应超时后端处理太慢二、业务自定义返回码接口 JSON 内的 code 字段业务语义各公司统一规范行业通用设计规律0/20000 代表成功正数为业务异常举例主流规范成功类0 / 20000业务执行成功data 返回正常数据如阿里云、多数后台系统用户认证类10001登录账号不存在10002密码错误10003Token 过期请重新登录10004验证码错误 / 失效参数校验类20001必填参数为空20002参数长度非法、格式错误手机号格式不对权限类30001普通用户越权访问管理员接口30002会员专属接口非会员禁止调用业务规则类40001库存不足下单失败40002订单已取消不可重复支付40003今日提现次数超限系统类50001数据库繁忙请稍后重试50002第三方支付接口调用失败