接口调不通的原因

接口没有任何响应

很多时候在做接口测试时，会发现接口没有任何返回，比如浏览器一直在转圈，或者返回一个空白页面。用接口测试工具时，工具报错，提示“no response”。

排查思路

  1. 先检查接口 ip 是否正确，可以通过在本机 ping 接口的 ip，检查网络是否通畅
  2. 再检查接口的端口号是否正确，可以通过在本机 telnet 接口的 ip 和端口号，检查端口是否能连通
  3. 检查项目是否启动或者部署成功，可以找研发确认，或者自己登录到服务器上，通过 ps 命令检查项目的进程是否存在，然后用 tail 命令查看部署日志
  4. 检查服务器防火墙是否关闭，如果因为安全或者权限问题不能关闭，需要找运维进行策略配置，开放对应的 ip 和端口号
  5. 检查你的客户端（浏览器/测试工具），是否设置了网络代理，网络代理可能会造成请求失败
  6. 检查操作系统的 host 文件，是否绑定了一个错误的 ip 映射

接口有响应但是返回了错误的状态码

有些时候接口会返回一些错误的 HTTP 状态码，需要根据不同的状态码来确定具体的原因。

排查思路

400：客户端请求错误，比如请求参数格式错误（如 json 字符串不合法）

401：未授权，比如在请求 header 里，缺乏必要的信息头（如 token、auth 等字段）

403：禁止，常见的原因是用户的账号没有对应的 url 权限，还有就是项目所用的中间件，不允许远程访问（比如 Apache）

404：资源未找到，导致这种情况的原因很多，比如：

  • url 写错了
  • url 后有空格
  • 项目没有启动成功
  • 请求协议不对，如 http/https

405：方法不允许，常见的原因是请求方式不正确，比如 GET 类型接口，使用 POST 方式去请求

415：不支持的媒体类型，常见原因是请求数据的类型和服务端支持的类型不匹配，比如 json 接口，需要添加一个信息头 Content-type:application/json

500：服务器内部错误，出现这种情况，说明服务端内部报错了，需要登录到服务器上，检查错误日志，根据具体的提示信息再进行排查

502/503/504（Bad Gateway/错误的网关、Service Unavailable/服务无法获得、Gateway Timeout/网关超时）

  • 如果单次调用接口就报该错误，说明是后端服务器配置有问题，或者服务不可用，挂掉了
  • 如果并发压测时出现此错误，说明是后端压力太大，出现异常，此问题一般是后端出现了响应时间过长或者无响应造成的