DC娱乐网

没有前端,API怎么测试?4种方法从手动调试到自动化一次讲清

做后端开发,经常会遇到一个问题:

接口已经写完了,但前端还没开始开发,这时候怎么知道 API 有没有问题?

很多人的做法是打开 Postman 或 Apifox,输入接口地址,点击发送,然后看到一个 200,就觉得测试完成了。



但实际上,返回 200,只能证明服务器给了一个正常的 HTTP 响应,并不能证明接口真的正确。

参数有没有问题?权限是否正确?返回的数据结构是否符合预期?异常情况能不能正常处理?多个接口串起来会不会出错?

这些都属于 API 测试。

如果没有前端,API到底应该怎么测?常见的方法其实有4种。

一、最简单:直接用 curl

如果只是临时测试一个接口,最简单的方法甚至不需要安装任何工具。

Linux、macOS、WSL 等环境通常都可以直接使用 curl。

比如测试登录接口:

curl -X POST http://localhost:8000/api/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"123456"}'

服务器返回 Token 后,再拿 Token 请求用户接口:

curl http://localhost:8000/api/user \
-H "Authorization: Bearer YOUR_TOKEN"

curl 最大的优势就是快。

遇到接口访问失败、Nginx 配置问题、跨域问题或者服务器环境异常时,可以直接从终端发请求,快速判断问题到底出在前端还是后端。

不过接口一多,curl 的问题也很明显。

几十个接口如果全部依靠命令管理,很快就会变得混乱。

所以 curl 更适合快速验证和故障排查,而不是大型项目的主要测试方案。

二、最常见:Postman、Apifox等工具

第二种应该是开发者最熟悉的方法。

这类工具最大的优势就是可视化。

GET、POST、PUT、DELETE,Header、Query、Body、Authorization,都可以直接配置。

例如:

POST /api/orders

设置 JSON:

{
"product_id": 1001,
"quantity": 2
}

点击发送,就可以直接看到服务器返回的数据。

更方便的是环境变量。

可以设置:

{{baseUrl}}

开发环境指向:

http://localhost:8000

测试环境则换成测试服务器。

登录接口获得 Token 后,还可以让后续请求自动使用:

Authorization: Bearer {{token}}

这样就不用每次手动复制 Token。

但这里有一个很容易被忽略的问题:

很多人只是用 API 工具“看接口”,并没有真正进行测试。

例如返回 200,然后看一眼 JSON,发现没明显问题,就结束了。

真正的测试应该加入断言:

状态码必须正确
字段必须存在
数据类型必须正确
Token必须存在
错误请求必须返回预期状态码

比如未登录应该得到 401,没有权限应该得到 403,参数验证失败可能是 422,资源不存在则应该是 404。

从“手动看结果”升级到“自动判断结果”,才算真正进入 API 测试。

三、更适合团队:Bruno这类代码化API测试工具

如果项目已经使用 Git,那么还有一种思路值得关注:

让 API 测试本身也成为项目文件。

Bruno 就属于这一类工具。

可以把接口按照业务进行组织:

api-tests/
├── auth/
├── users/
├── products/
└── orders/

这些测试文件可以直接进入 Git。

这样接口代码和 API 测试可以一起维护,而不是测试集合只存在于某个开发者电脑里。

它还有一个很实用的能力,就是把多个接口串起来。

例如:

登录
↓
获取 Token
↓
查询用户
↓
创建订单
↓
获取 orderId
↓
查询订单

创建订单以后,可以自动保存 orderId,然后继续请求订单详情。

这种测试比单独发送一个 POST 请求更有价值,因为它验证的是完整业务链路。

更重要的是,Bruno支持 CLI。

API 测试不一定需要打开图形界面,可以直接执行测试命令,并进一步接入 CI/CD。

于是整个流程可以变成:

提交代码
↓
CI自动执行API测试
↓
测试通过
↓
继续部署

这也是这类工具与普通 API 调试工具最大的区别之一。

四、真正自动化:PHPUnit等测试框架

第四种方法则更进一步。

对于 PHP 项目来说,可以使用 PHPUnit 等测试框架。

例如 Laravel 项目中,可以直接测试一个创建订单的 API:

$response = $this->postJson('/api/orders', [
'product_id' => 1001,
'quantity' => 2
]);

$response->assertStatus(201);

$response->assertJsonStructure([
'id',
'status',
'total'
]);

这种测试最大的特点是:

测试本身也是代码。

可以提交 Git,可以重复运行,也可以放进 CI。

而且 PHPUnit 测试的不只是 HTTP 请求,还可以覆盖 Service、Model、Repository、数据库以及具体业务规则。

所以 PHPUnit 和 Bruno并不是二选一。

一个更合理的结构是:

PHPUnit
负责代码和业务逻辑

Bruno
负责HTTP API和接口流程

CI
负责自动执行

三者组合起来,才能形成比较完整的后端测试体系。

API到底应该测试什么?

不管使用哪种工具,都不要把 API 测试理解成“检查一下有没有返回 200”。

一个完整的接口至少应该考虑几个方面。

第一是正常请求。

参数正确时,是否返回正确的数据。

第二是异常参数。

缺少参数、类型错误、参数为空、超出范围时,接口是否能够正确处理。

第三是身份认证和权限。

没有 Token、Token 过期、普通用户访问管理员接口,这些情况都应该测试。

第四是返回结构。

不仅要检查状态码,还要检查字段是否存在、数据类型是否正确、分页结构是否正确。

第五是接口之间的业务流程。

比如创建订单后,能不能正确查询订单;登录获得的 Token,能不能正常访问需要认证的接口。

这些问题,单独测试一个接口不一定能发现。

4种方法应该怎么选?

可以简单理解:

curl:最快,适合临时测试和故障排查。

Postman / Apifox:可视化程度高,适合日常开发和接口调试。

Bruno(collection):接口测试可以文件化、Git化,并且支持 CLI,更适合团队协作和自动化。

PHPUnit(测试框架):代码级自动化测试,适合测试业务逻辑、数据库以及 API。

实际项目中,它们完全可以组合使用。

开发时先用 curl 快速排查问题,再用 Bruno 或其他 API 工具管理接口,同时用 PHPUnit 测试核心业务逻辑,最后通过 CI 自动执行。

这样一来,即使前端页面还没有完成,后端也完全可以把 API 测试起来。

前端只是 API 的使用者,而不是 API 测试的前提。

对于后端开发来说,越早建立 API 测试习惯,越容易在前端接入之前发现问题,也能减少大量“前端一联调才发现后端接口有问题”的情况。