Azure Storage File ShareClient调用CreateIfNotExists()抛出重试失败异常

结合你提供的错误信息、代码和环境配置，我整理了几个优先级较高的排查方向，你可以逐一尝试解决：

1. 强制启用TLS 1.2协议 #

Azure存储服务目前要求客户端使用TLS 1.2及以上版本进行连接，而.NET 4.6.2/4.7.2默认可能不会主动强制使用TLS 1.2，这会导致连接被服务器主动关闭。

在你的代码开头添加以下配置，强制指定TLS版本：

System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

如果是.NET 4.7+，也可以通过app.config/web.config配置全局TLS策略，避免硬编码：

<configuration>
  <system.net>
    <settings>
      <servicePointManager securityProtocol="Tls12" />
    </settings>
  </system.net>
</configuration>

2. 修复同步调用异步方法的潜在问题 #

Azure SDK的CreateIfNotExists()方法底层是基于异步实现的，在同步上下文（比如控制台Main方法）直接调用可能会引发死锁或上下文异常，进而导致连接异常。

推荐改为异步调用模式：

static async Task Main(string[] args)
{
    var connectionString = "DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net;";
    var shareClient = new ShareClient(connectionString, "testfileshare");
    await shareClient.CreateIfNotExistsAsync();
}

如果必须保持同步调用，建议使用.GetAwaiter().GetResult()替代直接阻塞，避免上下文冲突：

shareClient.CreateIfNotExistsAsync().GetAwaiter().GetResult();

3. 升级Azure存储SDK版本 #

你使用的Azure.Storage.Files.Shares 12.4.0是2020年的旧版本，后续版本修复了大量连接重试、TLS兼容性相关的bug。建议通过NuGet包管理器将其升级到最新稳定版（当前最新为12.18.x系列），新版本对.NET框架的兼容性和稳定性都有显著提升。

4. 排查网络环境限制 #

• 测试端点连通性：在浏览器中访问https://<your-account-name>.file.core.windows.net/testfileshare，如果返回403错误（权限问题）说明网络连通正常；如果无法打开页面，说明网络存在拦截。
• 代理服务器配置：如果你的环境使用代理，需要在app.config中添加代理配置，确保SDK能通过代理访问Azure服务：

  <system.net>
    <defaultProxy enabled="true" useDefaultCredentials="true">
      <proxy usesystemdefault="True" />
    </defaultProxy>
  </system.net>
  

• 防火墙/安全组检查：确认本地防火墙、公司网络防火墙是否允许出站到Azure存储服务的443端口，是否有设备拦截了TLS握手流程。

5. 验证连接字符串与权限 #

• 直接从Azure门户复制完整的连接字符串，避免手动输入时的拼写错误（尤其是AccountKey中的特殊字符）。
• 确认存储账户密钥拥有足够的权限：至少需要Storage File Data Contributor或包含Share Create/Share Read权限的自定义角色。

6. 捕获更详细的异常信息 #

AggregateException可能包含多个内部异常，你可以展开捕获，获取更具体的错误细节（比如SSL证书验证失败、TLS握手错误等）：

try
{
    shareClient.CreateIfNotExists();
}
catch (AggregateException ex)
{
    foreach (var innerException in ex.Flatten().InnerExceptions)
    {
        Console.WriteLine($"详细错误: {innerException.Message}");
        Console.WriteLine($"堆栈跟踪: {innerException.StackTrace}");
    }
}

这些细节能帮你更精准定位问题根源。

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