Azure中SAS+CDN的Content Disposition功能失效问题咨询

我之前踩过一模一样的坑！直接用Blob存储的SAS URL带rscd参数能正常返回自定义文件名，但走CDN就失效，核心原因是Azure CDN默认不会自动传递Blob存储生成的Content-Disposition响应头，且缓存策略可能把不同SAS参数的请求当成同一资源缓存。下面是亲测有效的解决方案：

一、先搞懂关键原因 #

当你用Blob的SAS URL（带rscd或新版disposition参数）访问时，Blob存储会自动在响应头里添加Content-Disposition: attachment;filename=xxx，浏览器靠这个头识别自定义文件名。但CDN默认可能：

• 过滤掉这个自定义响应头
• 把带不同SAS参数的请求当成相同URL缓存，返回旧的响应头

二、分步解决 #

1. 改用新版SAS参数（推荐） #

旧版的rscd参数是针对2017-07-29及更早的API版本，新版API建议使用disposition参数。生成SAS时，直接指定ContentDisposition属性（比如在代码里用BlobSasBuilder.ContentDisposition = "attachment;filename=tsv.jpg"），这样生成的SAS URL会包含disposition=attachment%3Bfilename%3Dtsv.jpg参数，Blob存储返回的响应头会更标准，CDN也更容易识别。

2. 调整CDN的查询字符串缓存策略 #

如果你的CDN端点设置为「忽略查询字符串」，它会把所有带不同SAS参数的请求当成同一个资源缓存，导致文件名不生效。需要改成：

• 进入Azure Portal → 你的CDN端点 → 「缓存规则」
• 找到「查询字符串缓存行为」，设置为「包含查询字符串」或「缓存每个唯一的URL」
• 保存设置后，记得手动清除CDN缓存（避免旧缓存干扰）

3. 用CDN规则引擎强制传递Content-Disposition头 #

这是最关键的一步，确保CDN不会过滤掉Blob返回的自定义响应头：

• 进入CDN端点 → 「规则引擎」
• 添加一条新规则：
  • 条件：选择「请求URL」→ 「包含」，输入sig=（因为SAS URL必然包含sig参数）
  • 动作：选择「修改响应头」→ 「保留」，头名称填Content-Disposition，让CDN原样传递Blob存储返回的头值；如果是固定文件名需求，也可以直接设置头值为attachment;filename=你的自定义名称.jpg
• 保存规则，等待几分钟生效

4. 测试验证 #

用CDN的SAS URL访问，比如：

https://test-cdn.azureedge.net/data/images/111-111-111-11?sig=<sig>&se=2018-04-18T22%3A32%3A27Z&sv=2021-08-06&disposition=attachment%3Bfilename%3Dtsv.jpg&sp=r&sr=b

打开浏览器的开发者工具（Network标签），查看该请求的响应头，确认Content-Disposition存在且值正确，然后下载文件看文件名是否符合预期。

三、额外注意事项 #

• 如果用的是Azure CDN from Verizon/Akamai，规则引擎的操作界面可能略有不同，但核心逻辑一致：保留或设置Content-Disposition头
• 每次调整规则后，一定要清除CDN缓存，否则旧的缓存响应会影响测试结果
• 确保SAS的权限（sp参数）包含r（读取），否则会返回403错误

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