Filament v3多租户下，文档归属Bucket而非Team的上传问题求助

问题根源 #

你的多层租户结构是Team -> Bucket -> Document，但当前配置让Filament错误地将顶层租户Team的ID直接关联到Document表（尝试写入team_id），而Document表只有bucket_id字段，导致上传失败。

解决方案 #

1. 修正DocumentResource的租户配置

明确指定Document的直接租户是Bucket，而非Team：

protected static ?string $model = Document::class;
// 指定Document所属的直接租户模型
protected static ?string $tenantModel = Bucket::class;
// 指定Document模型中关联Bucket的关系名（对应模型里的belongsTo方法名）
protected static ?string $tenantRelationshipName = 'bucket';

2. 调整App面板的租户关系配置

确保Team与Bucket的关联关系配置正确，让Filament能识别租户层级：

// 这里的'buckets'对应Team模型中关联Bucket的HasMany关系名
tenant(Team::class, ownershipRelationship: 'buckets')

3. 自动填充Bucket ID到CreateAction

在文档创建动作中，自动注入当前上下文的Bucket ID，无需手动选择：

protected function getHeaderActions(): array
{
    return [
        Actions\CreateAction::make()
            ->form([
                FileUpload::make('name')
                    ->required()
                    ->storeFileNamesIn('original_filename')
            ])
            ->mutateFormDataUsing(function (array $data, $livewire): array {
                // 获取当前页面上下文的Bucket租户
                $bucket = $livewire->getTenant();
                $data['bucket_id'] = $bucket->id;
                return $data;
            })
    ];
}

4. 验证模型关系正确性

确保各模型的关联关系定义准确：

• Document模型：

class Document extends Model
{
    public function bucket(): BelongsTo
    {
        return $this->belongsTo(Bucket::class);
    }
}

• Bucket模型：

class Bucket extends Model
{
    public function team(): BelongsTo
    {
        return $this->belongsTo(Team::class);
    }

    public function documents(): HasMany
    {
        return $this->hasMany(Document::class);
    }
}

• Team模型：

class Team extends Model
{
    public function buckets(): HasMany
    {
        return $this->hasMany(Bucket::class);
    }
}

原理说明 #

通过以上配置，Filament会正确识别Document的直接租户是Bucket，在创建文档时自动关联当前上下文的Bucket ID，而不是错误地尝试写入team_id字段，从而解决上传失败的问题。

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