带api_key参数的URI图片无法通过StartCopyFromUriAsync复制到Azure存储的问题

问题原因 #

是的，这正是因为目标图片并非真正公开可访问。StartCopyFromUriAsync是由Azure Storage服务器端发起的跨存储复制请求，当目标URL包含api_key这类验证参数时，通常会因为以下原因失败：

1. 目标服务器会校验请求发起方身份，Azure Storage的服务器请求未通过验证（比如目标服务器限制了请求来源的IP、Referer等），直接被拒绝；
2. 部分服务器会对api_key的使用场景做限制，仅允许客户端（浏览器或指定应用）发起的请求，不允许第三方服务直接通过URL调用。

这种情况下Azure服务器拉取不到图片内容，就会生成0KB的空Blob，复制状态标记为Failed，并返回通用500错误。而公开图片没有验证限制，Azure服务器能正常拉取内容，所以复制成功。

解决方案 #

最可靠的处理方式是改用流上传方案，由你的应用先从目标URL获取图片流，再上传到Azure Blob。这样请求从你的应用发起，能正常通过目标服务器的验证：

// 建议复用HttpClient实例，避免频繁创建销毁导致Socket资源耗尽
private static readonly HttpClient _httpClient = new HttpClient();

public async Task CopyImageToBlobAsync(string imageUrl, BlobClient blobClient)
{
    using var imageStream = await _httpClient.GetStreamAsync(imageUrl);
    // 第二个参数设为true表示覆盖已存在的Blob
    await blobClient.UploadAsync(imageStream, overwrite: true);
}

如果场景有特殊需求，也可以尝试以下备选方案，但适用性有限：

• 联系目标服务器管理员，将Azure Storage的IP范围加入目标服务器白名单，或者调整api_key权限，允许Azure服务器发起的请求访问；
• 若目标服务器支持，可将api_key放到请求头中（而非URL参数），但StartCopyFromUriAsync无法自定义请求头，因此仍需通过流的方式实现。

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