Lumen是Laravel的超轻量API框架，启动快2–3倍但禁用Session等Web组件；开发需设APP_DEBUG=true、LOG_LEVEL=debug；路由须手动注册；Eloquent需显式启用；响应需用response()->json()。
直接上结论：Lumen 是 Laravel 的超轻量分支，专为构建高性能 API 服务设计；它默认禁用 Session、View、Cookie 等 Web 相关组件，启动耗时比 Laravel 快 2–3 倍，但代价是部分 Laravel 习惯不能直接照搬。
安装后第一件事：确认 APP_DEBUG 和 LOG_LEVEL 配置
Lumen 默认关闭错误显示，APP_DEBUG=false 且不输出详细异常堆栈——这会让本地开发调试变得“静默失败”。生产环境要关，开发阶段必须开。
-
.env中设APP_DEBUG=true，否则 500 错误只返回空白页或{"message":"Server Error"} -
LOG_LEVEL=debug才能捕获中间件、路由匹配、数据库查询等完整日志 - 注意：Lumen 不读取
config/app.php中的debug键，只认环境变量
routes/web.php 里写 API 路由？别这么做
Lumen 默认只有 routes/web.php，但它不是为 Web 页面服务的——它是历史遗留命名，实际应全部用于 API 路由。更重要的是：Lumen 不自动加载该文件，你得手动在 bootstrap/app.php 中启用：
$app->router->group([
'namespace' => 'App\Http\Controllers',
], function ($router) {
require __DIR__.'/../routes/web.php';
});
- 不加这层
$app->router->group(...)包裹，路由注册无效，请求 404 且无提示 - 若要用
api/前缀，直接在 group 数组里加'prefix' => 'api'，别依赖 RouteServiceProvider - Lumen 没有
Route::middleware()的链式调用语法，得用数组形式：['middleware' => ['auth:api']]
数据库查询报错 Call to undefined function App\Http\Controllers\table()
这是新手最高频的误用：Lumen 默认不启用 Eloquent 的全局辅助函数（如 table()、DB::table() 可用，但 table('users') 不行），且 Model 类需显式引入 Illuminate\Database\Eloquent\Model，不能靠自动加载猜。
立即学习“PHP免费学习笔记（深入）”；
- 确保
bootstrap/app.php中已取消注释：$app->withEloquent(); - Model 文件顶部必须写：
use Illuminate\Database\Eloquent\Model;，否则class User extends Model会报类未定义 - 想用
DB::，无需额外操作；但想用table()这类辅助函数，得手动引入：use Illuminate\Support\Facades\DB;并调用DB::table('users') - 迁移命令是
php artisan migrate，但 Lumen 默认不带migrate:rollback—— 需在bootstrap/app.php中补上：$app->register(Illuminate\Database\MigrationServiceProvider::class);
最常被忽略的一点：Lumen 的 Response 默认不自动 JSON 化——return ['data' => $user]; 会输出纯 PHP 数组字符串，而非 JSON。必须显式用 response()->json() 或在控制器方法上加 @return \Illuminate\Http\JsonResponse 注解（仅 IDE 提示，不强制）。没做这步，前端收不到标准 JSON，连 Content-Type 都是 text/html。
