领域事件应传递何种类型的数据？现有实现合理性咨询

问题背景 #

我为此困惑多日，仍未明确领域事件的正确实现方式。网上示例各异，目前看到的可选方案有：

• 仅传递原始值（primitive values）
• 传递完整模型
• 传递与领域/模型变更相关的值对象（value objects）新实例
• 为每个事件创建专属DTO/数据对象

当前不认可的PHP实现 #

MyModel.php #

class MyModel {
     //...
     private MediaId $id;
     private Thumbnails $thumbnails;
     private File $file; 
     //...
    public function delete(): void
    {
        $this->record(
            new MediaDeleted(
                $this->id->asString(),
                [
                    'name' => $this->file->name(),
                    'thumbnails' => $this->thumbnails->toArray(),
                ]
            )
        );
    }
}

MediaDeleted.php #

final class MediaDeleted extends AbstractDomainEvent
{
    public function name(): string
    {
        return $this->payload()['name'];
    }

    /**
     * @return array<ThumbnailArray>
     */
    public function thumbnails(): array
    {
        return $this->payload()['thumbnails'];
    }
}

如上所示，我向MediaDeleted事件传递了字符串类型的ID、文件名，以及Thumbnail值对象属性数组。

请问该实现是否合理？领域事件更适合传递何种类型的数据？

更新后的实现方案 #

受@pgorecki的答案启发，为尽量少改动代码，我调整了实现方案：

public function delete(): void
{
    $this->record(
        new MediaDeleted(
            $this->id,
            new MediaDeletedEventPayload($this->file->copy(), $this->thumbnail->copy())
        )
    );
}

说明：聚合根ID仍在DTO外，因MediaDeleted继承的抽象类需该参数。我将原payload数组替换为MediaDeletedEventPayload DTO，向其传递领域变更相关值对象的副本，避免传递同一实例引发异常行为。

请问此方案是否合理？

解答 #

原始实现的合理性分析 #

原始实现有一定实用性，但存在明显缺陷：

1. 数据结构无约束：用数组作为payload，缺乏类型校验，后续维护易出现字段拼写错误、类型不匹配问题，IDE也无法提供有效提示。
2. 值对象封装性破坏：将Thumbnails转为数组传递，丢失了值对象的业务语义，事件消费者需要额外解析数组还原信息，增加冗余逻辑和出错风险。
3. 扩展性差：如果后续业务需要新增事件关联数据，频繁修改payload数组会破坏事件结构的稳定性，影响向后兼容性。

领域事件的理想数据传递原则 #

领域事件核心是传递事件发生时的事实信息，需满足以下要求：

• 不可变性：事件数据一旦生成不能修改，因此传递的值对象必须是独立副本，避免聚合根后续状态变更影响事件数据。
• 语义明确：用专属DTO或值对象封装事件数据，让事件内容一目了然，消费者无需解析松散数组，直接通过方法获取业务数据。
• 最小必要：只传递事件相关的关键数据，不要传递完整模型（会带来序列化开销、数据泄露风险，违反单一职责），也不要过度传递无关信息。

更新后方案的评价 #

更新后的方案非常合理，解决了原始实现的核心问题：

1. 强类型约束：MediaDeletedEventPayload提供了明确的类型定义，IDE可给出代码提示，后续修改事件数据更可控，代码可读性大幅提升。
2. 保证数据不可变：通过copy()传递值对象副本，彻底隔离了事件数据与聚合根状态，符合领域事件的设计原则。
3. 兼容现有架构：保留聚合根ID在DTO外，兼顾原有抽象类的约束，无需大规模重构，实现了平滑过渡。

若要进一步优化，可考虑：

• 让MediaDeletedEventPayload具备完全不可变性（所有属性设为私有，仅提供只读获取方法），杜绝事件数据被篡改的可能。
• 在MediaDeleted事件中封装MediaDeletedEventPayload的业务方法，不让消费者直接操作payload对象，进一步隐藏实现细节。

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