如何快速上手LaravelAPI，编写首个LaravelHelloWorldAPI接口？

本文共计1068个文字，预计阅读时间需要5分钟。

新手上路，常误以为API就是高大上，直接抄文档里带版本、中间件、资源控制器的写法。结果连+404+都搞不定，要么是路由没注册，要么是中间件拦了。第一个接口只求通，不求全。

实操建议：

• 在 routes/api.php 里写最简路由：

  Route::get('/hello', function () { return ['message' => 'Hello World']; });

• 别加 middleware('api') —— Laravel 9+ 默认已为 api.php 自动加载该中间件，手动加反而可能重复触发
• 别用 php artisan make:controller Api/HelloController 再绑定路由，函数式写法更直白，避免控制器空壳和命名空间错位
• 访问时必须带 /api/ 前缀（如 http://localhost:8000/api/hello），这是 Laravel 对 routes/api.php 的硬编码约定，不是可配选项

Response::json() 不需要显式调用，数组自动转 JSON

看到别人代码里写 return response()->json(['msg' => 'ok'])，就以为“返回 JSON 必须这么写”，其实纯属冗余。