EPiServer 11.10.1媒体Blob迁移至Azure存储账户遇404错误求助

针对你遇到的Azure Blob存储404问题，结合你的配置和已做的排查步骤，我整理了几个核心的排查方向和解决方案：

关于appData basePath的疑问 #

先直接回答你的问题：appData basePath=""不需要特意设置值来配合Azure Blob存储。当你在blob节点配置了defaultProvider="azureblobs"后，EPiServer会自动切换到使用Azure Blob Provider来处理媒体文件，不再依赖本地文件系统的basePath配置，所以这个配置不是导致问题的原因。

核心排查方向与解决方案 #

1. 版本兼容性问题（最可能的原因） #

你当前绑定的EPiServer.Azure版本是9.4.4.0，但你的EPiServer版本是11.10.1，这两个版本存在兼容性断层。EPiServer 11对应的Azure Provider版本应该是11.x系列，9.x版本是为EPiServer 9设计的，强行绑定会导致内部API调用不匹配，进而引发找不到Blob的错误。

解决方案：

• 升级EPiServer.Azure NuGet包到与EPiServer 11兼容的版本（比如11.2.0或更高同系列版本）。
• 更新web.config中的绑定重定向，匹配你安装的NuGet包版本：

  <dependentAssembly>
    <assemblyIdentity name="EPiServer.Azure" publicKeyToken="8fe83dea738b45b7" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-11.2.0.0" newVersion="11.2.0.0" />
  </dependentAssembly>
  

2. Blob路径与数据库存储不匹配 #

EPiServer在数据库的tblContentBlob表中存储了每个媒体文件的BlobUri，如果迁移到Azure时，Blob的路径/名称和数据库中的记录不匹配，就会出现404错误。比如：

• 旧DFS路径是/dfs-shared/globalassets/image.jpg，但迁移到Azure后Blob的路径是mycontainer/image.jpg，而数据库中还是旧的路径。
• 手动迁移时，没有保留EPiServer内部的虚拟路径结构（比如globalassets/前缀）。

解决方案：

• 确认迁移工具（或手动上传）是否将Blob以和数据库中BlobUri一致的路径存储到Azure容器中。比如数据库中BlobUri是/globalassets/hero.jpg，那么Azure容器中应该存在globalassets/hero.jpg这个Blob（容器作为根目录）。
• 使用Azure Storage Explorer查看容器内的Blob结构，对比数据库中的记录，确保路径完全匹配。

3. 容器名称或连接字符串细节问题 #

虽然你已经做了初步验证，但还是要注意几个细节：

• Azure存储容器名称是区分大小写的，且必须是小写字母、数字和短横线，不能有大写或特殊字符。确认web.config中container="mycontainer"和Azure中的容器名称完全一致。
• 检查连接字符串中的AccountName和AccountKey是否正确，可以用Azure Storage Explorer测试连接，确保能正常访问容器和Blob。

4. EPiServer缓存与初始化问题 #

有时候EPiServer会缓存旧的Blob Provider配置，导致没有正确加载Azure Provider。

解决方案：

• 停止站点，删除App_Data目录下的Cache和Index文件夹，清理缓存。
• 重启站点后，查看日志中是否有EPiServer.Azure.Blobs.AzureBlobProvider初始化成功的记录，确认Provider被正确加载。

额外验证步骤 #

尝试在EPiServer后台上传一张新的媒体文件，查看是否能成功保存到Azure容器中：

• 如果新文件可以正常显示，说明当前配置是有效的，问题出在旧迁移文件的路径匹配上；
• 如果新文件也报错，那大概率是版本兼容性或连接配置的问题。

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