如何通过Postman测试Laravel API，解决/api/v1/test路由访问400错误

第一步：校验路由注册状态 #

在项目根目录执行终端命令查看所有注册路由：
php artisan route:list
确认返回结果中存在对应条目：

• 请求方法为GET|HEAD
• 路径为api/v1/test
• 绑定的控制器方法为Api\TestController@test，同时确认控制器文件存在于app/Http/Controllers/Api目录下，命名空间、类名、方法名无拼写错误
• 挂载的中间件无额外的权限、签名校验要求

第二步：确认路由定义位置 #

Laravel默认会给routes/api.php内的所有路由自动添加/api前缀，你贴出的路由代码必须放在routes/api.php文件中才能匹配/api/v1/test路径。如果代码写在了routes/web.php中，正确访问地址应为http://localhost/v1/test，无需加/api前缀。

第三步：调整Postman请求配置 #

• 请求方法必须选择GET，不要使用POST/PUT等其他方法
• 如果你没有配置虚拟主机指向Laravel的public目录，不要直接访问localhost，优先使用Laravel内置开发服务：终端执行php artisan serve，默认服务地址为http://127.0.0.1:8000，对应接口地址为http://127.0.0.1:8000/api/v1/test
• 请求头必须添加Accept: application/json，避免Laravel返回非预期格式触发错误
• 检查TestController的test方法是否有参数验证规则，若存在必填参数校验但你没有携带对应参数，就会返回400错误，比如方法内写了如下规则：

public function test(Request $request)
{
    $request->validate([
        'user_id' => 'required'
    ]);
}

这种情况需要在请求中携带参数：http://127.0.0.1:8000/api/v1/test?user_id=123

第四步：定位具体错误原因 #

400状态码属于客户端请求错误，通常会附带具体错误说明，你可以直接查看Postman返回的响应正文内容，根据错误提示（比如参数缺失、格式错误等）调整请求即可。

内容的提问来源于stack exchange，提问作者FreezyCompe