Laravel API 路由 404 错误的常见原因与解决方案-php教程-PHP中文网

Laravel API 路由 404 错误的常见原因与解决方案

Laravel 默认将 api.php 中定义的所有路由自动添加 /api/ 前缀，因此直接访问 localhost:8000/data 会返回 404；正确路径应为 localhost:8000/api/data。

laravel 默认将 `api.php` 中定义的所有路由自动添加 `/api/` 前缀，因此直接访问 `localhost:8000/data` 会返回 404；正确路径应为 `localhost:8000/api/data`。

在 Laravel 中，API 路由被统一托管在 routes/api.php 文件中，而该文件由框架默认通过 RouteServiceProvider 加载，并自动应用 /api 前缀和中间件组（如 api 中间件）。这意味着你写在 api.php 中的任何路由，都会隐式地挂载在 /api 下——无论你是否显式写出该前缀。

例如，若你在 routes/api.php 中定义如下路由：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

// routes/api.php
use Illuminate\Http\Request;

Route::get('/data', function (Request $request) {
    return response()->json(['message' => 'Hello from API!']);
});

实际可访问的完整 URL 是：
✅ http://localhost:8000/api/data

而非：
❌ http://localhost:8000/data（触发 404）

? 验证方式：运行 php artisan route:list --path=api 或 php artisan route:list | grep "api/data"，可清晰看到注册的路由 URI 为 GET api/data。

其他注意事项：

✅ 确保已启动开发服务器：php artisan serve（默认监听 http://localhost:8000）；
✅ 检查 .env 中 APP_URL 设置是否影响 CORS 或前端请求（但不影响后端路由匹配）；
⚠️ 不要混淆 web.php 和 api.php：前者用于带 Session 的 Web 页面路由（无 /api 前缀），后者专为无状态 API 设计（强制 /api 前缀）；
?️ 如需移除 /api 前缀（不推荐，违背 Laravel 最佳实践），可修改 app/Providers/RouteServiceProvider.php 中的 mapApiRoutes() 方法，但会失去 api 中间件（如频率限制、无 CSRF）等关键能力。