Filament Fabricator页面块渲染报错：Page参数为null的排查与解决

基于Laravel和Filament，参照Wire-Content-v2项目结构搭建CMS时，渲染页面块遇到报错：

Z3d0X\FilamentFabricator\PageBlocks\PageBlock::preloadRelatedData(): Argument #1 ($page) must be of type Z3d0X\FilamentFabricator\Models\Contracts\Page, null given, called in /Users/admin/Herd/alayen_site/storage/framework/views/6874f6ca5f37860ea4db0a70882621cd.php on line 45

复现步骤 #

• 克隆GitHub上的Wire-Content-v2仓库
• 执行依赖安装命令：

  composer install
  composer update
  npm install && npm run dev
  

• 从composer.json中移除本地仓库配置及matildevoldsen/wire-content依赖
• 添加新菜单和页面后尝试渲染页面块

已尝试操作 #

• 切换数据库为SQLite
• 清理Laravel各类缓存
• 检查页面模型传递是否正确

报错核心是渲染页面块时，传递给preloadRelatedData()方法的$page参数为null，触发类型验证失败。结合操作步骤，具体原因可能有：

1. 移除matildevoldsen/wire-content依赖后，原项目中与页面模型绑定的逻辑被破坏，新添加的页面未正确关联Filament Fabricator要求的Page契约模型。
2. 页面渲染视图中调用preloadRelatedData()时，未正确获取到当前页面实例，可能是路由解析、模型查询或视图传参环节出错。
3. 新添加的页面数据未正确写入数据库，或查询时未找到对应记录，导致返回null。

1. 确保页面模型实现Filament Fabricator的Page契约 #

检查项目的页面模型（通常为App\Models\Page）是否正确实现Z3d0X\FilamentFabricator\Models\Contracts\Page接口，并完成接口要求的方法实现：

namespace App\Models;

use Z3d0X\FilamentFabricator\Models\Contracts\Page as PageContract;
use Illuminate\Database\Eloquent\Model;

class Page extends Model implements PageContract
{
    public function getBlocksAttribute()
    {
        return $this->attributes['blocks'] ?? [];
    }

    public function getSlugAttribute()
    {
        return $this->attributes['slug'];
    }

    // 实现其他接口要求的方法
}

2. 检查视图传参逻辑 #

执行php artisan view:clear清除缓存视图后，找到触发报错的原视图文件，确保调用preloadRelatedData()时传入有效的Page实例：

{{-- 错误示例：传入null --}}
@foreach($page->blocks as $block)
    {!! $block->preloadRelatedData(null)->render() !!}
@endforeach

{{-- 正确示例：传入当前页面实例 --}}
@foreach($page->blocks as $block)
    {!! $block->preloadRelatedData($page)->render() !!}
@endforeach

3. 验证页面数据与路由解析 #

• 检查数据库中新增页面的记录，确认slug、blocks等字段存在有效值。
• 检查路由逻辑，确保访问页面时能正确查询到对应Page模型：

Route::get('/{page:slug}', function (App\Models\Page $page) {
    return view('page', compact('page'));
});

4. 重新发布Filament Fabricator视图 #

若原项目视图依赖wire-content，移除后可重新发布Filament Fabricator的默认视图，确保逻辑合规：

php artisan vendor:publish --tag=filament-fabricator-views

内容的提问来源于stack exchange，提问作者Abdul Hadi