Laravel无唯一标识的Pivot表中文档更新处理方案咨询

我正在开发一个Laravel项目，从API获取包含关联文档的产品数据。产品与文档是多对多关系，文档存储在独立表中，通过product_document中间表关联。当前遇到的问题是API返回的文档无唯一标识，无法准确判定针对某一产品的文档应执行更新还是新建操作。

API响应示例 #

$productdata = [
    'id' => 757,
    'code' => 'tee',
    'name' => 'Long tee shirt',
    'supplier_productcode' => 'Penshoppe',
    'weight' => 5,
    'unit' => 0,
    'stocklevel' => 100,
    'min_stocklevel' => 0,
    'documents' => [
        [
            'name' => 'productDocs.PDF',
            'size' => 70984,
        ],
        [
            'name' => 'shirtDesign.PDF',
            'size' => 110868,
        ],
    ],
    'updated_at' => '2023-05-23 13:39:18',
];

相关表结构与模型代码 #

中间表（product_document） #

• id：主键
• product_id：产品表外键
• document_id：文档表外键

产品表 #

• id：主键
• api_id：API返回的产品ID

文档表 #

• id：主键
• name：文档名称
• size：文档大小

产品模型关联代码 #

public function documents(): BelongsToMany
{
    return $this->belongsToMany(Document::class, 'product_document')->using(ProductDocument::class);
}

当前数据处理代码 #

foreach ($products as $product) {
    $product_lastUpdate = $product['updated_at'];

    if (Carbon::parse($product_lastUpdate) == '2023-05-23 13:39:18') {
        // 产品更新或创建代码
        $upProduct = Product::updateOrCreate(
            [
                'api_id' => $product['id']
            ],                    
            [
                'api_id' => $product['api_id'],
                'code' => $product['code'],
                'name' => $product['name'],
                'supplier_productcode' => $product['supplier_productcode'],
                'weight' => $product['weight'],
                'unit' => $product['unit'],
                'stocklevel' => $product['stocklevel'],
                'min_stocklevel' => $product['min_stocklevel'],
            ] 
        );

        // 文档更新或创建代码
        foreach ($product['documents'] as $key => $document) {
            // 无唯一标识时如何处理更新或创建？
        }
    }
}

解决方案 #

由于API未返回文档唯一ID，可通过特征组合判定或增强字段的方式解决，以下是三种实用方案：

方案一：基于名称+大小的联合唯一判定 #

单独的名称或大小可能重复，但两者组合的唯一性概率极高。先给文档表添加联合唯一索引，再用updateOrCreate处理：

1. 添加联合唯一索引（迁移文件）：

Schema::table('documents', function (Blueprint $table) {
    $table->unique(['name', 'size']);
});

2. 修改文档处理逻辑：

$newDocumentIds = [];

foreach ($product['documents'] as $document) {
    // 用名称+大小作为唯一条件，更新或创建文档
    $doc = Document::updateOrCreate(
        ['name' => $document['name'], 'size' => $document['size']],
        ['name' => $document['name'], 'size' => $document['size']]
    );
    $newDocumentIds[] = $doc->id;
}

// 同步产品与文档关联，自动移除不在新列表中的关联
$upProduct->documents()->sync($newDocumentIds);

方案二：基于产品关联的特征匹配 #

如果担心不同产品存在同名同大小的文档，可限定在当前产品关联范围内判定：

// 先获取当前产品已关联的所有文档
$currentDocs = $upProduct->documents()->get();
$newDocumentIds = [];

foreach ($product['documents'] as $document) {
    // 在当前产品关联文档中查找匹配项
    $existingDoc = $currentDocs->firstWhere(function ($doc) use ($document) {
        return $doc->name === $document['name'] && $doc->size === $document['size'];
    });

    if ($existingDoc) {
        // 存在则更新（若有其他字段需更新可在此添加）
        $existingDoc->update(['size' => $document['size']]);
        $newDocumentIds[] = $existingDoc->id;
    } else {
        // 不存在则创建并关联
        $newDoc = Document::create([
            'name' => $document['name'],
            'size' => $document['size']
        ]);
        $newDocumentIds[] = $newDoc->id;
    }
}

// 移除当前产品关联但API未返回的文档
$upProduct->documents()->sync($newDocumentIds);

方案三：添加文档哈希值（精准度最高） #

如果能获取文档内容，可计算哈希值（如MD5/SHA1）作为唯一标识，彻底避免重复：

1. 给文档表添加哈希字段（迁移文件）：

Schema::table('documents', function (Blueprint $table) {
    $table->string('hash')->unique();
});

2. 处理代码中计算哈希（假设能获取文档内容或下载链接）：

$newDocumentIds = [];

foreach ($product['documents'] as $document) {
    // 示例：从API返回的内容或下载链接计算哈希
    $fileContent = file_get_contents($document['url']); // 需替换为实际获取内容的逻辑
    $hash = md5($fileContent);

    $doc = Document::updateOrCreate(
        ['hash' => $hash],
        ['name' => $document['name'], 'size' => $document['size'], 'hash' => $hash]
    );
    $newDocumentIds[] = $doc->id;
}

$upProduct->documents()->sync($newDocumentIds);

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