Strapi始终使用本地存储而非谷歌云/Cloudinary上传插件求助

核心问题 #

已严格遵循官方文档配置@strapi-community/strapi-provider-upload-google-cloud-storage和@strapi/provider-upload-cloudinary插件，甚至新建项目按教程操作，Strapi仍强制使用本地存储保存媒体文件，项目依赖Google Cloud服务，需切换至对应云存储。

排查步骤与解决方案 #

1. 插件安装与依赖校验 #

• 确认插件已正确安装，检查package.json中是否存在对应依赖：

  // package.json 示例片段
  "dependencies": {
    "@strapi-community/strapi-provider-upload-google-cloud-storage": "^x.x.x",
    // 或 "@strapi/provider-upload-cloudinary": "^x.x.x"
    "@strapi/strapi": "^4.x.x"
  }
  

• 若依赖存在但未生效，删除node_modules和package-lock.json/yarn.lock，重新执行npm install或yarn install，确保依赖版本与Strapi主版本兼容（比如Strapi 4.x需对应插件的4.x版本）。

2. 插件配置文件校验 #

Google Cloud Storage 配置

确保config/plugins.ts（或config/plugins.js）配置正确，且环境变量已加载：

// config/plugins.ts
export default ({ env }) => ({
  upload: {
    config: {
      provider: '@strapi-community/strapi-provider-upload-google-cloud-storage',
      providerOptions: {
        serviceAccount: JSON.parse(env('GOOGLE_SERVICE_ACCOUNT')),
        bucketName: env('GOOGLE_BUCKET_NAME'),
        baseUrl: env('GOOGLE_BASE_URL'), // 可选，如"https://storage.googleapis.com/your-bucket"
        basePath: env('GOOGLE_BASE_PATH'), // 可选，媒体文件存储路径前缀
      },
    },
  },
});

• 注意：GOOGLE_SERVICE_ACCOUNT需是完整的JSON字符串（不含换行），或通过文件路径加载（需确保Strapi有权限读取该文件）。

Cloudinary 配置

若使用Cloudinary，配置示例：

// config/plugins.ts
export default ({ env }) => ({
  upload: {
    config: {
      provider: '@strapi/provider-upload-cloudinary',
      providerOptions: {
        cloud_name: env('CLOUDINARY_NAME'),
        api_key: env('CLOUDINARY_KEY'),
        api_secret: env('CLOUDINARY_SECRET'),
      },
      actionOptions: {
        upload: {},
        delete: {},
      },
    },
  },
});

3. 环境变量加载校验 #

• 确认.env文件中的变量名与配置文件完全一致，无拼写错误：

  # Google Cloud Storage 示例
  GOOGLE_SERVICE_ACCOUNT='{"type":"service_account","project_id":"...",...}'
  GOOGLE_BUCKET_NAME=your-bucket-name
  GOOGLE_BASE_URL=https://storage.googleapis.com/your-bucket-name
  
  # Cloudinary 示例
  CLOUDINARY_NAME=your-cloud-name
  CLOUDINARY_KEY=your-api-key
  CLOUDINARY_SECRET=your-api-secret
  

• 重启Strapi服务，确保环境变量已重新加载，可通过console.log(env('GOOGLE_BUCKET_NAME'))在配置文件中打印变量，验证是否正确读取。

4. Middleware 配置检查 #

确保config/middleware.ts中未禁用upload中间件，默认配置应包含：

// config/middleware.ts
export default ({ env }) => ({
  settings: {
    // ...其他中间件配置
    upload: {
      enabled: true,
    },
  },
});

5. Strapi 权限与缓存清理 #

• 清理Strapi缓存：删除.strapi目录，重启服务。
• 确认Google Cloud服务账号拥有Storage Object Creator和Storage Object Viewer权限，Bucket设置为公共可读（或配置正确的CORS规则，确保前端可访问媒体文件）。
• 若使用Cloudinary，确认API密钥权限正确，无IP限制或其他访问限制。

6. 测试与日志排查 #

• 上传测试文件后，查看Strapi控制台日志，若有报错信息（如权限不足、配置错误），根据报错定位问题。
• 检查Google Cloud Storage/Cloudinary控制台，确认是否有文件上传记录（即使Strapi显示本地路径，可能实际已上传但路径未更新）。

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