在EPiServer v11.20.14站点配置Azure Blob Storage触发400错误请求

问题背景 #

将EPiServer站点的Blob提供程序从文件共享迁移至Azure Storage后，添加配置到web.config导致站点崩溃，返回400错误，异常指向Azure存储请求失败。环境信息：

• .NET Framework 4.6.1
• EPiServer.CMS v11.20.14
• EPiServer.Azure v9.4.4
• WindowsAzure.Storage 8.5.0

可能的原因及解决步骤 #

1. 容器名称不符合Azure存储命名规则 #

Azure存储容器名称必须满足：

• 全小写字母
• 仅包含字母、数字和短横线（-）
• 长度3-63字符
• 不能以短横线开头或结尾
• 不能包含连续的短横线

检查配置中的container="mycontainer"是否严格符合上述规则，若有不符合的情况，修改容器名称并同步Azure端的容器名称。

2. 连接字符串配置问题 #

WindowsAzure.Storage 8.5.0对连接字符串的格式可能有特定要求：

• 尝试移除EndpointSuffix=core.windows.net，旧版本SDK可能会自动处理默认后缀
• 确认账户名称和密钥是否复制正确，注意密钥末尾的==是否完整，避免多余空格或字符

修改后的连接字符串示例：

<add name="EPiServerAzureBlobs" connectionString="DefaultEndpointsProtocol=https;AccountName=xxxxxxx;AccountKey=xxxxxxx=="/>

3. 版本兼容性问题 #

虽然EPiServer.Azure 9.4.4官方推荐搭配WindowsAzure.Storage 8.5.0，但可能存在版本冲突：

• 尝试将WindowsAzure.Storage降级至8.4.0，部分用户反馈该版本与EPiServer.Azure 9.x兼容性更好
• 确保所有相关Azure NuGet包版本一致，避免混合不同版本的依赖

4. 存储账户的网络或权限限制 #

• 检查存储账户的防火墙设置：若开启了IP白名单，确认服务器的公网IP已添加至允许列表
• 确认存储账户类型为通用v1或v2，EPiServer.Azure 9.x可能不支持Blob存储专用账户
• 验证存储账户密钥的有效性：通过Azure Portal生成新的访问密钥，替换连接字符串中的密钥后测试

5. 容器初始化逻辑问题 #

异常堆栈显示错误发生在DefaultAzureBlobContainer.CreateIfNotExist()，可能是容器创建时的权限问题：

• 手动在Azure Portal创建目标容器，设置容器的公共访问级别为私有（默认），再启动站点测试
• 确保连接字符串使用的是账户密钥（而非SAS令牌），且账户拥有Blob容器的创建权限

6. 异步初始化死锁问题 #

异常中涉及Task.WaitAll，可能存在异步同步等待导致的死锁：

• 在web.config的<episerver.framework>节点中添加asyncInitialization="false"，强制同步初始化：

<episerver.framework asyncInitialization="false">
  <!-- 其他配置 -->
</episerver.framework>

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