Magento 2 可下载商品：停止文件上传版本化功能

核心思路 #

针对可下载商品的上传流程，放弃原有的文件名递增重命名逻辑，改为绑定商品唯一存储路径，实现同名文件自动覆盖或先删后传，确保已购买用户的下载链接永久有效，同时避免冗余文件占用存储。

具体实现步骤 #

1. 存储路径标准化配置 #

• 为每个供应商的可下载商品分配唯一固定存储路径，格式示例：sellers/{seller_id}/products/{product_id}/main.zip
  • 路径嵌入供应商ID和商品ID，确保每个商品的文件路径全局唯一，从根源避免文件名冲突
  • 强制所有可下载商品的文件统一命名为main.zip（或固定后缀），无需依赖原始上传文件名

2. 存储桶权限调整（针对云存储服务） #

• 开启存储桶的同名文件覆盖权限（如AWS S3的PUT允许覆盖、阿里云OSS的覆盖写入），确保上传时直接替换同路径下的旧文件
• 配置供应商的存储桶访问策略，限制其仅能操作自己名下sellers/{seller_id}/路径下的文件，防止越权操作

3. 上传逻辑代码改造 #

• 定位供应商文件上传的核心处理模块，移除原有的文件名递增逻辑
• 实现二选一的上传逻辑：
  • 直接覆盖模式：上传时直接使用商品对应的固定存储路径，依赖存储桶原生覆盖能力，伪代码示例：

    def upload_product_file(seller_id, product_id, file):
        target_path = f"sellers/{seller_id}/products/{product_id}/main.zip"
        storage_client.upload_fileobj(file, target_path, overwrite=True)
        update_product_db(product_id, download_path=target_path)
    

  • 先删后传模式：上传前先查询商品对应的旧文件路径，调用存储桶API删除后再上传新文件，适合需要严格日志记录的场景：

    def upload_product_file(seller_id, product_id, file):
        target_path = f"sellers/{seller_id}/products/{product_id}/main.zip"
        # 删除旧文件
        if storage_client.file_exists(target_path):
            storage_client.delete_file(target_path)
            log_operation(seller_id, product_id, "old_file_deleted")
        # 上传新文件
        storage_client.upload_fileobj(file, target_path)
        update_product_db(product_id, download_path=target_path)
        log_operation(seller_id, product_id, "new_file_uploaded")
    

• 在商品数据表中新增download_file_path字段，存储该商品对应的固定存储路径，下载时直接读取该路径返回给用户

4. 历史冗余文件清理 #

• 编写批量处理脚本，遍历所有可下载商品：
  1. 查找每个商品下的所有历史重命名文件（如filename_1.zip、filename_2.zip）
  2. 将最新版本的文件移动到该商品的固定存储路径
  3. 更新商品表的download_file_path字段
  4. 删除所有历史冗余文件
• 脚本运行完成后，验证所有已购买用户的下载链接是否正常跳转至新路径

5. 安全与校验补充 #

• 增加文件格式校验：仅允许上传Zip格式文件，拦截其他类型文件
• 记录上传操作日志：包括供应商ID、商品ID、上传时间、文件MD5值，方便后续问题回溯
• 实现文件大小限制：根据业务需求设置单文件最大上传容量，防止超大文件占用资源

效果验证 #

1. 使用测试供应商账号对同一商品多次上传同名Zip文件，检查存储桶中是否仅保留最新版本，旧文件被覆盖/删除
2. 访问已购买用户的下载链接，验证是否能正常下载最新版本的文件
3. 测试多供应商同时操作不同商品，确认文件路径隔离有效，无互相干扰情况

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