后端接口排查

后端接口问题要先确认请求是否到达服务，再区分是参数、鉴权、业务逻辑、数据库还是外部依赖问题。

排查流程

flowchart TD
    A[接口异常] --> B[确认 URL 和方法]
    B --> C[查看状态码]
    C --> D{是否到达后端}
    D -- 否 --> E[检查网关/代理/端口]
    D -- 是 --> F[查看请求参数和用户身份]
    F --> G[查看业务日志]
    G --> H[检查数据库和外部依赖]

状态码理解

状态码	含义
400	参数错误
401	未登录或 Token 无效
403	无权限
404	路径不存在或路由未匹配
500	服务内部异常
502/504	网关或上游服务异常

建议

1. 日志中记录 traceId，前后端和网关都带上。
2. 参数校验失败要返回明确字段。
3. 生产环境不要把完整堆栈返回给前端。
4. 慢接口要结合 SQL、外部调用和线程池一起看。