Magento 2客户后台批量上传文档/图片异常求助：仅保存单张

以下是针对问题的具体排查和修复步骤：

1. 检查前端文件输入字段配置 #

确认批量上传的文件输入框name属性为数组格式且带有multiple属性，比如：

<input type="file" name="customer_attachments[]" multiple="multiple" />

如果name未加[]，后端只能接收到第一个上传文件，导致其余文件丢失。

2. 验证PHP上传限制配置 #

检查服务器的php.ini参数，确保：

• max_file_uploads：值需大于1（默认20），此参数限制单次请求可上传的文件总数
• post_max_size：需大于所有上传文件的总大小
• upload_max_filesize：需大于单文件最大上传尺寸

可通过在服务器创建phpinfo.php文件查看当前配置。

3. 修复后端控制器文件处理逻辑 #

找到客户后台上传对应的控制器文件（比如Vendor/Module/Controller/Adminhtml/Customer/Upload.php），确保代码遍历所有上传文件，而非仅处理第一个。示例修正代码：

if (isset($_FILES['customer_attachments']) && !empty($_FILES['customer_attachments']['name'][0])) {
    $files = $_FILES['customer_attachments'];
    // 遍历所有上传文件
    for ($i = 0; $i < count($files['name']); $i++) {
        $tmpFilePath = $files['tmp_name'][$i];
        $fileName = $files['name'][$i];
        $fileType = $files['type'][$i];
        
        // 跳过空文件
        if (empty($tmpFilePath) || !is_uploaded_file($tmpFilePath)) {
            continue;
        }
        
        // 执行文件验证、移动到媒体库、关联客户实体等逻辑
        // ...
    }
}

4. 检查媒体目录权限 #

确保客户上传文件的存储目录权限正确，执行以下命令：

# 替换www-data为你的web服务器用户组
chown -R www-data:www-data pub/media/customer
chmod -R 775 pub/media/customer

权限不足会导致后续文件无法写入存储目录。

5. 验证Magento系统上传配置 #

进入后台Stores > Configuration > Advanced > System > Upload Restrictions，确认：

• 未设置Maximum Upload File Count为1
• 文件类型、大小限制未批量上传的文件

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