Postman 测试 Laravel 11 API 需正确配置认证头（Authorization: Bearer {token}）、路由前缀（/api）、JSON 格式（Headers 含 Accept/Content-Type: application/json）及禁用 CSRF，确保路由定义在 api.php 并应用 api 中间件组。
Postman 是测试 Laravel 11 API 最常用、最直观的工具之一。关键在于正确配置请求（尤其是认证、CSRF 和 JSON 格式），并理解 Laravel 11 默认的 API 路由与中间件行为。
1. 确保 Laravel 11 API 路由已正确配置
Laravel 11 默认使用 routes/api.php，所有路由自动加前缀 /api，且默认应用 api 中间件组（含 throttle:api 和无 session/CSRF）。这意味着：
- 无需手动设置
X-CSRF-TOKEN或 Cookie 登录（除非你主动启用了 web 中间件） - 若用 Sanctum 或 Passport 做 API 认证，需额外携带 token（如
Authorization: Bearer {token}） - 检查
config/api.php中的throttle配置，避免测试时被限流（可临时注释或调高限制）
2. Postman 中设置基础请求参数
以 GET 请求 /api/users 为例：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- Method：选择 GET
- URL：http://your-app.test/api/users（确保域名和端口与本地开发环境一致，如使用 Laravel Sail/Valet/Docker）
- Headers 标签页添加：
Accept: application/json
Content-Type: application/json
（Laravel 会据此返回 JSON 响应，而非重定向或视图）
3. 测试带认证的 API（以 Laravel Sanctum 为例）
若你的 API 受 Sanctum 保护（如 auth:sanctum 中间件）：
- 先用 Postman 发起登录请求（POST
/api/login），Body → raw → JSON，传入{"email":"test@example.com","password":"password"} - 成功后响应中会返回一个
token（或自动在响应头Authorization中返回 Bearer token） - 后续请求在 Headers 中添加：
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9... - 注意：Sanctum 的 token 是无状态的，不需要刷新，但需确保
sanctum.php中stateful域名包含你的 Postman 请求域名（如['localhost', '127.0.0.1']）
4. 测试 POST/PUT/PATCH 请求（发送 JSON 数据）
例如创建用户：
- Method：POST
- URL：http://your-app.test/api/users
- Headers：
Accept: application/json
Content-Type: application/json - Body → raw → JSON：
{ "name": "Alice", "email": "alice@example.com", "password": "password123" } - 如果遇到
422 Unprocessable Content，检查响应中的errors字段，确认字段名、必填项和验证规则是否匹配
5. 调试小技巧
遇到问题时快速定位：
- 在 Postman 的 Console（View → Show Postman Console）中查看完整请求/响应日志
- Laravel 日志位于
storage/logs/laravel.log，可配合Log::info('API hit')打点 - 临时在控制器中加
return response()->json(['debug' => request()->all()]);查看接收数据 - 若返回 401 或 419，大概率是认证失败或 CSRF 误用——确认没把 API 路由错放在
web.php中
