Filament 4 不支持 Laravel 12；官方仅兼容 Laravel 10/11，v5 同样不支持 Laravel 12，且目前无适配计划；升级 Laravel 12 后安装 Filament 4 会触发 Composer 冲突。

Filament 4 目前（2026年11月）不支持 Laravel 12。

官方明确要求：

• Filament v4 兼容 Laravel 10 和 Laravel 11；
• Filament v5（2026年1月发布）同样只支持 Laravel 10/11，并专为 Livewire v4 设计；
• 截至目前，Laravel 12 尚无任何 Filament 版本提供支持，也未在 Filament 官方 GitHub 或文档中宣布适配计划。

你如果已升级到 Laravel 12，直接 composer require filament/filament:^4.0 会触发 Composer 冲突，典型报错类似：

Root composer.json requires filament/filament ^4.0 -> satisfiable by filament/filament[4.0.0, ..., 4.9.9]  
but those require laravel/framework ^10.0 || ^11.0 -> found laravel/framework[v12.0.0] but it does not match the constraint.

---

✅ 正确路径：降级 Laravel 或等待适配

1. 退回 Laravel 11（推荐短期方案）

Laravel 11 是当前 LTS（长期支持）版本，稳定、安全、生态成熟，且与 Filament v4/v5 完全兼容。
执行以下操作即可快速切换：

# 卸载 Laravel 12
composer remove laravel/framework

# 安装 Laravel 11（例如 11.30.x，最新稳定 LTS 分支）
composer require laravel/framework:^11.0

# 同步其他核心包（如 illuminate/*）
composer update "illuminate/*" --with-all-dependencies

⚠️ 注意：Laravel 12 引入了 PHP 8.4 原生特性（如 pattern matching）、重构的 HTTP Kernel 和新的事件调度器，若项目已重度依赖这些新特性，需评估回退成本。

2. 暂停升级，等 Filament 官方适配

Filament 团队通常在 Laravel 新版发布后 2–4 个月内推出兼容版本。Laravel 12 发布于 2026年9月，按节奏预计 Filament v6 可能在 2027年第一季度发布并声明支持。可关注：

• Filament GitHub Releases
• Filament Discord #announcements

3. 不建议的替代方案（慎用）

• ❌ 强制忽略版本约束（--ignore-platform-reqs）：会导致运行时 Class not found 或 Method not found，因底层契约（如 Illuminate\Contracts\Routing\Registrar）已变更；
• ❌ 自行 fork + patch Filament：维护成本极高，无法享受更新与安全修复；
• ❌ 切换后台框架（如 Nova、Backpack）：同样暂无 Laravel 12 支持，且迁移代价不亚于回退 Laravel。

---

✅ Laravel 11 + Filament 4 标准安装流程（确认可用）

确保环境满足：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• PHP ≥ 8.1
• Node.js ≥ 18
• APP_URL 和数据库配置正确

# 1. 安装 Filament（v4 或 v5 均可，代码完全兼容）
composer require filament/filament:"^4.0"

# 2. 运行安装命令（生成面板结构）
php artisan filament:install --panels

# 3. 手动注册路由（关键！否则 /admin 404）
# 在 routes/web.php 末尾添加：
use Filament\Facades\Filament;
Filament::routes();

# 4. 创建管理员用户（推荐用命令行）
php artisan make:filament-user

# 5. 迁移并启动
php artisan migrate
php artisan serve

访问 http://localhost:8000/admin 即可登录使用。

---

? 补充提醒：常见连带问题

• 模型必须显式声明契约：
  app/Models/User.php 中需有

  use Filament\Panel\Traits\HasFilamentTableColumns;

• 表单字段不入库？ 检查 $fillable 是否包含字段名（严格匹配下划线命名，不自动转驼峰）；

• 媒体库上传失败？ 需单独安装插件：

  composer require filament/spatie-laravel-media-library-plugin:"^4.0"

• Nginx 404？ 确保重写规则含：

  try_files $uri $uri/ /index.php?$query_string;

不复杂但容易忽略。