做后端开发,经常会遇到一个问题:
接口已经写完了,但前端还没开始开发,这时候怎么知道 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 测试习惯,越容易在前端接入之前发现问题,也能减少大量“前端一联调才发现后端接口有问题”的情况。