求助：Strapi搭配Cloudinary时，管理面板上传xlsx文件报错

我之前帮朋友排查过类似的问题，结合你的描述——Cloudinary控制台能传但Strapi不行，报错“Unsupported ZIP file”，核心原因大概率是Strapi的文件类型限制或者Cloudinary插件的资源类型配置不对，毕竟XLSX本质是ZIP格式的文件，Strapi可能误判了它的类型。下面是一步步的解决建议：

1. 检查并更新Strapi允许的文件类型 #

Strapi的Upload插件默认有一组允许的文件类型，可能不包含XLSX对应的MIME类型。你需要显式添加它到配置里：

找到项目根目录下的config/plugins.js（TypeScript项目对应config/plugins.ts），在upload插件的配置中添加allowedFileTypes字段，把XLSX的MIME类型加进去：

module.exports = ({ env }) => ({
  upload: {
    config: {
      provider: 'cloudinary',
      providerOptions: {
        cloud_name: env('CLOUDINARY_NAME'),
        api_key: env('CLOUDINARY_KEY'),
        api_secret: env('CLOUDINARY_SECRET'),
      },
      actionOptions: {
        upload: {},
        delete: {},
      },
      // 显式添加允许的文件类型，包含XLSX
      allowedFileTypes: [
        'image/jpeg',
        'image/png',
        'image/gif',
        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' // XLSX的MIME类型
      ],
    },
  },
});

修改后重启Strapi服务，再尝试上传XLSX文件。

2. 配置Cloudinary插件的资源类型 #

Cloudinary把文件分为不同的资源类型：图片（image）、视频（video）、原始文件（raw）。默认情况下Strapi的Cloudinary插件可能用image类型上传所有文件，但XLSX属于raw类型，这会导致上传失败。

你可以在actionOptions.upload里指定资源类型为raw：

actionOptions: {
  upload: {
    resource_type: 'raw' // 强制用raw类型上传非图片文件
  },
  delete: {},
},

如果需要同时支持图片和XLSX，也可以写简单逻辑动态判断，但先试试全局设置raw是否能解决问题。

3. 更新Cloudinary插件到最新版本 #

旧版本的Strapi Cloudinary插件可能对非图片文件的支持不完善，建议更新到最新版本：

# npm用户
npm install strapi-provider-upload-cloudinary@latest

# yarn用户
yarn add strapi-provider-upload-cloudinary@latest

更新后重启服务再测试。

4. 排查Strapi的ZIP文件检测逻辑 #

因为XLSX本质是ZIP压缩包，Strapi可能内置了ZIP文件的检测规则，误把XLSX当成普通ZIP文件并阻止上传。你可以尝试把application/zip也加入到allowedFileTypes里，看看是否能绕过这个检测，但这只是临时方案，更推荐确保XLSX的MIME类型被正确识别。

5. 验证前端上传的MIME类型 #

如果是用自定义前端上传而非Strapi管理面板，打开浏览器开发者工具，查看上传请求的FormData，确认文件的MIME类型是application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，而不是application/zip。如果前端传递的MIME类型错误，也会导致Strapi报错。

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