必须指定稳定版本号创建Lumen项目，如composer create-project laravel/lumen:^10.0 my-lumen-app；启用Eloquent和Facades需取消bootstrap/app.php中对应行注释；确保文件末尾仅return $app；APP_KEY须首次部署前生成。
直接用 composer create-project 创建 Lumen 项目是可行的，但官方早已弃用 Lumen 的独立安装器，且当前主流版本（Lumen 10+）基于 Laravel 10+ 内核，必须通过 Composer 指定稳定版本，否则默认拉取 dev-main 或不兼容快照，导致 php artisan 报错、服务启动失败或路由不生效。
用 composer create-project 创建时必须指定稳定版本号
Lumen 官方不再维护无版本号的全局安装命令，composer create-project laravel/lumen 默认会尝试安装 dev-main，而该分支依赖未锁定的 Laravel nightly 组件，极易引发 Class 'Laravel\Lumen\Application' not found 或 Target class [App\Http\Controllers\Controller] does not exist 等致命错误。
- ✅ 正确做法：显式指定已发布稳定版，例如
composer create-project laravel/lumen:^10.0 my-lumen-app - ⚠️ 注意：Lumen 9 对应 PHP 8.0+，Lumen 10 要求 PHP 8.1+，检查
php -v再选版本 - ? 若需最小化安装（跳过 dev 依赖），加
--no-dev参数，但首次运行php artisan key:generate前别删symfony/var-dumper，否则调试时 var_dump 报错
创建后必须手动启用 Eloquent 和 Facades（默认关闭）
Lumen 出厂默认禁用 Eloquent ORM 和大部分 Laravel Facades（如 Cache、DB、Log），这是性能优化设计，但新手常因没开就直接写 DB::table() 导致 Class 'DB' not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
bootstrap/app.php，取消注释这两行：$app->withEloquent();$app->withFacades(); - 若只需部分 Facade（比如只用
Log），可改用：$app->withFacades(true, ['Log' => Illuminate\Support\Facades\Log::class]); - ⚠️ 不要提前调用
$app->configure('database')—— Lumen 10+ 已自动加载，手动加会导致重复注册配置异常
artisan 命令无法运行？检查 bootstrap/app.php 中的 $app 实例初始化顺序
常见现象：执行 php artisan key:generate 报 Call to a member function configure() on null，本质是 $app 变量在 bootstrap/app.php 末尾未被正确返回，或被意外覆盖。
- 确认文件末尾有且仅有一行：
return $app; - 禁止在
bootstrap/app.php中写任何输出语句（echo、var_dump）、require 其他含输出的文件，否则破坏 HTTP header 或 artisan 输出协议 - 若使用 Docker 或 CLI 环境 PATH 异常，优先用绝对路径运行：
php ./artisan key:generate而非php artisan
Lumen 的轻量本质藏在配置开关里，不是代码越少越安全，而是每个关闭项都得清楚它关了什么、开了会引入什么依赖。最常被跳过的其实是 .env 文件权限和 APP_KEY 生成时机 —— 本地跑通不等于部署可用，APP_KEY 必须在首次部署前生成并写入环境变量，否则加密/Session 全失效。
