You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Strapi v4 Azure存储插件仍将文件保存至本地服务器求助

Strapi v4 Azure存储文件仍存本地问题排查方案
  • 确认上传插件配置正确性
    检查config/plugins.js(或config/upload.js)的配置结构,确保provider设置为azure-storage,而非默认的local,示例配置如下:

    module.exports = ({ env }) => ({
      upload: {
        config: {
          provider: 'azure-storage',
          providerOptions: {
            account: env('AZURE_STORAGE_ACCOUNT'),
            accountKey: env('AZURE_STORAGE_ACCOUNT_KEY'),
            containerName: env('AZURE_STORAGE_CONTAINER_NAME'),
            defaultPath: 'uploads',
            cdnBaseUrl: env('AZURE_CDN_URL'),
          },
        },
      },
    });
    

    注意:容器名称必须在Azure存储中已存在,且配置参数无拼写错误。

  • 验证环境变量有效性
    确认部署环境(或本地.env文件)中的Azure相关环境变量已正确配置,无大小写错误或注释情况,例如:

    AZURE_STORAGE_ACCOUNT=你的存储账户名
    AZURE_STORAGE_ACCOUNT_KEY=你的存储密钥
    AZURE_STORAGE_CONTAINER_NAME=你的容器名
    
  • 检查依赖适配性
    确认已安装适配Strapi v4的strapi-provider-upload-azure-storage依赖,避免安装v3版本。可重新执行安装命令并重启Strapi:

    npm install strapi-provider-upload-azure-storage
    npm run build && npm run start
    
  • 查看启动日志排查错误
    启动Strapi时观察控制台日志,若存在上传插件加载失败、Azure存储权限不足、容器不存在等错误提示,根据提示修复对应问题(如创建容器、调整存储密钥权限)。

  • 确认Azure容器访问权限
    将Azure存储容器的访问级别设置为Blob或Container,若为Private级别,需确保配置的存储密钥拥有Blob写入权限。

内容的提问来源于stack exchange,提问作者SerkanOzvatan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 03:32:45