文档Experience Cloud KCS

由于不支持或无法识别的MIME类型，文件上传或提取失败

最近更新： 2026年6月22日

当MIME类型无法识别或识别错误时，文件上传、存档提取和附件处理可能会失败。 出现此问题是因为缺少MIME类型映射、上载配置受限制或已禁用基于内容的检测。 因此，文件会被拒绝、在提取期间跳过，或分配了未定义的MIME类型。 要解决此问题，请更新MIME映射，调整上传限制，并确保正确的检测设置。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM Forms

问题/症状

  • 上传失败，因为​不支持的媒体类型 — <文件名> ：未定义
  • ZIP提取日志指示使用mimeType null创建的文件
  • 提取存档操作后缺少Assets
  • 附件组件拒绝有效的文件类型
  • 在处理日志中，MIME类型显示为未定义或null

根本原因
系统使用请求标头和内部映射确定MIME类型。 当映射缺失或配置错误时，MIME类型将分配为null或未定义。 上载限制可能会阻止此类文件，并且禁用的基于内容的检测可能会导致文件类型分类不正确。

如何确认

  • 检查日志中指示不支持的、空或未定义的MIME类型的错误
  • 验证元数据属性中分配给上载文件的MIME类型
  • 检查提取日志中跳过的文件或缺少的条目
  • 查看受影响文件扩展名的MIME类型映射
  • 检查上载限制配置是否阻止已识别的MIME类型

解决方法 resolution

  1. 使用日志或元数据属性标识分配给失败文件的MIME类型。
  2. 在MIME类型服务配置中添加所需的MIME类型映射。
  3. 更新资产上传限制配置以允许识别的MIME类型。
  4. 如果扩展未能正确识别MIME类型，则启用基于内容的MIME检测。
  5. 确保存档文件中包含的所有文件扩展名都存在MIME类型映射。
  6. 更新组件配置以允许处理附件所需的MIME类型。
  7. 重新部署或重新启动配置以应用更改。
  8. 通过重新上传或重新处理文件并确认正确的MIME类型分配进行验证。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles