Filament v3安装后php artisan filament:install报“command not found”是因为服务提供者未加载：Laravel 10需运行composer dump-autoload，Laravel 11+需php artisan optimize:clear或package:discover；必须用--panels参数，--admin已废弃；路由需手动确保routes/filament.php被加载且RouteServiceProvider中含mapFilamentRoutes()。
Filament v3 的安装不是“装完就能用”，关键卡点在服务提供者注册、命令可用性、路由加载这三步。跳过任一环节，php artisan filament:install 报错或访问 /admin 404 就是必然结果。
为什么 php artisan filament:install 提示 command not found
这个错误和 Composer 是否装成功无关，本质是 Laravel 没识别到 Filament 的 Artisan 命令。v3 要求服务提供者被正确加载，且配置已发布。
- 确认执行了
composer require filament/filament:"^3.0"，并检查vendor/filament/filament目录存在 - Laravel 10 及以下：必须运行
composer dump-autoload - Laravel 11+：改用
php artisan optimize:clear清缓存（dump-autoload不再足够） - 仍无效？手动触发包发现：
php artisan package:discover - 检查
config/app.php是否误删了Filament\FilamentServiceProvider::class—— Laravel 11+ 已移除此文件，靠自动发现，删了反而坏事
--panels 是唯一合法参数，--admin 已废弃
v3 彻底弃用 --admin，它只属于 v2。用错参数会导致资源生成失败、配置结构错乱，甚至后续 php artisan make:filament-resource 报错。
- 必须使用
php artisan filament:install --panels - 该命令会生成
config/filament.php、routes/filament.php和app/Providers/Filament/AdminPanelProvider.php - 如果项目里已有
App\Providers\FilamentProvider.php（v2 风格），先手动删掉再运行 install，否则冲突 - 不加参数直接运行
filament:install会进交互式选择，但脚手架逻辑不稳定，不建议依赖
访问 /admin 404 或空白登录页的真正原因
这不是安装失败，而是路由没被 Laravel 加载。v3 的面板路由定义在 routes/filament.php，但这个文件不会自动引入。
- 检查
routes/web.php或routes/api.php是否误删了 Laravel 默认的路由加载逻辑 - 确保
routes/filament.php存在且内容非空 - 确认
app/Providers/RouteServiceProvider.php中的map()方法调用了$this->mapFilamentRoutes()—— v3 安装后应自动添加，若缺失需手动补上：
protected function mapFilamentRoutes(): void
{
Route::middleware('web')
->domain(config('app.url'))
->group(base_path('routes/filament.php'));
}
- 中间件拦截也会导致空白页：检查
app/Providers/Filament/AdminPanelProvider.php中的auth()->user()是否返回 null，或是否误配了自定义守卫
最易被忽略的一点：v3 不再兼容 v2 的用户模型路径和迁移结构。如果你复用旧项目，users 表被前后台共用时，务必提前规划权限隔离策略，而不是等登录失败才回头改模型和中间件。
