使用Azure CDN主机名调用download_blob时出现"Required Content-Range response header is missing or malformed"错误

我太懂你这种头疼的情况了——明明浏览器里直接访问CDN的SAS URL能正常下载，用原始Blob存储的主机名时SDK代码也跑得好好的，换成CDN hostname就突然抛出Content-Range相关的错误。咱们来捋清楚问题根源，再试试几个靠谱的解决办法：

问题根源 #

Azure Blob Storage SDK的download_blob方法默认会用分块下载的逻辑，这个逻辑严重依赖Blob存储服务返回的Content-Range响应头来管理分块的范围和进度。但Azure CDN在缓存并返回内容时，默认不会保留这个特定的响应头，或者返回的格式不符合SDK的预期，导致SDK无法解析，直接抛出错误。

可行的解决方案 #

方案1：强制SDK使用单次下载，跳过分块逻辑

让SDK一次性下载整个Blob，这样就不会触发对Content-Range头的依赖。你可以通过设置max_concurrency=1来实现：

with open("download_file.wav", "wb") as current_blob:
    # 强制单次下载，避免分块逻辑
    stream = blob_client.download_blob(max_concurrency=1)
    current_blob.write(stream.readall())

如果需要更明确地指定下载整个Blob，也可以结合Blob属性来写：

blob_properties = blob_client.get_blob_properties()
with open("download_file.wav", "wb") as current_blob:
    stream = blob_client.download_blob(offset=0, length=blob_properties.size, max_concurrency=1)
    current_blob.write(stream.readall())

方案2：调整CDN缓存规则，保留Content-Range响应头

你可以在Azure门户里修改CDN的缓存规则，让它把Content-Range头传递给客户端：

• 打开你的Azure CDN资源，进入「缓存规则」页面
• 针对Blob存储的端点，创建或修改自定义缓存规则
• 在「响应头」区域，把Content-Range添加到「保留的头」列表中
• 保存规则后等待几分钟生效，之后SDK的分块下载逻辑就能正常识别响应头了

方案3：绕过SDK，直接用HTTP请求下载

既然浏览器能直接下载，咱们也可以用Python的requests库直接发GET请求，完全避开SDK对响应头的严格校验：

import requests

# 使用你生成好的blob_sas_url
response = requests.get(blob_sas_url)
response.raise_for_status()  # 确保请求没有出错
with open("download_file.wav", "wb") as f:
    f.write(response.content)

补充说明 #

你之前尝试修改EndpointSuffix或者指定offset和size的方式没解决问题，是因为即使指定了下载范围，SDK仍然会期望CDN返回符合格式的Content-Range头，而CDN默认没传递这个头，所以还是会报错。

备注：内容来源于stack exchange，提问作者Echo