本文目录导读：
- 目录导读
- 为什么需要批量刷新CDN缓存？——常见场景与痛点
- 脚本刷新CDN缓存的几种主流方法
- 实战：编写一个通用的批量刷新脚本（Python示例）
- 关键注意事项：避免踩坑
- 问答环节：解决你最常见的5个疑问
- 总结：从手动到自动，提高运维效率
目录导读
- 为什么需要批量刷新CDN缓存？——常见场景与痛点
- 脚本刷新CDN缓存的几种主流方法
- 实战：编写一个通用的批量刷新脚本（Python示例）
- 关键注意事项：避免踩坑（频率、鉴权、覆盖范围）
- 问答环节：解决你最常见的5个疑问
- 从手动到自动，提高运维效率
为什么需要批量刷新CDN缓存？——常见场景与痛点
当你的网站部署了CDN（内容分发网络）后，静态资源（如图片、CSS、JS、HTML）会被缓存到边缘节点，但在以下情况下，你必须强制清除这些缓存：
- 更新上线：修改了样式的JS/CSS，但用户依然看到旧版本。
- 紧急修复：部署了安全补丁或修复了关键Bug，需要所有节点立即同步。
- 资源替换：替换了某个大图的URL，但旧图片仍在边缘节点提供服务。
手动刷新几百个URL或目录不仅耗时,还容易遗漏，而脚本批量刷新能通过API接口，一次性提交数千个URL或整个目录，效率提升数百倍，目前主流CDN（如阿里云CDN、腾讯云CDN、Cloudflare）均提供REST API，支持自动化的批量操作。
脚本刷新CDN缓存的几种主流方法
| 方法 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| API批量提交 | 需要刷新指定URL列表时 | 灵活，可指定精确缓存路径 | 需要编写代码，且有API调用频率限制 |
| 目录刷新 | 整个目录更新或网站改版时 | 一次操作清除整个目录，无需列举所有URL | 可能会导致大量缓存错失，增加源站负载 |
| 刷新预拉取结合 | 新资源需要立即生效并预缓存 | 不仅清除旧缓存，还能立刻缓存新资源 | 消耗更多带宽配额，注意成本 |
核心思路：无论你使用哪个CDN服务商，流程基本都是：
- 使用API Key或Token鉴权。
- 构造包含待刷新URL或目录的JSON请求体。
- 通过HTTP POST请求提交到CDN的刷新API。
- 轮询或等待刷新任务完成。
实战：编写一个通用的批量刷新脚本（Python示例）
以下脚本可与“阿里云CDN”或“腾讯云CDN”适配（仅需修改API地址和鉴权方式），它读取一个urls.txt文件（每行一个URL），然后分批提交（避免单次提交过多URL导致失败）。
import requests
import json
import time
from typing import List
# 请替换为你的CDN服务商的真实配置
ACCESS_KEY_ID = "your_access_key"
ACCESS_KEY_SECRET = "your_secret"
API_ENDPOINT = "https://cdn.api.aliyun.com/v1.0/refresh"
def batch_refresh_cdn(urls: List[str], batch_size: int = 100):
"""批量刷新CDN缓存，每次最多提交batch_size个URL"""
total = len(urls)
success_count = 0
fail_count = 0
for i in range(0, total, batch_size):
batch = urls[i:i+batch_size]
payload = {
"ObjectType": "File", # 或 "Directory"
"ObjectPath": batch
}
# 模拟API请求（实际需要签名）
headers = {"Authorization": f"AccessKey {ACCESS_KEY_ID}:{ACCESS_KEY_SECRET}"}
try:
response = requests.post(API_ENDPOINT, json=payload, headers=headers, timeout=10)
if response.status_code == 200:
success_count += len(batch)
print(f"批次 {i//batch_size + 1}: 成功提交 {len(batch)} 个URL")
else:
fail_count += len(batch)
print(f"批次 {i//batch_size + 1}: 失败，原因: {response.text}")
except Exception as e:
fail_count += len(batch)
print(f"批次 {i//batch_size + 1}: 异常 {str(e)}")
time.sleep(1) # 避免触发API限流
print(f"执行完成：成功 {success_count}，失败 {fail_count}")
if __name__ == "__main__":
with open("urls.txt", "r") as f:
url_list = [line.strip() for line in f if line.strip()]
batch_refresh_cdn(url_list, batch_size=100)
关键点解释：
batch_size=100：大多数CDN API单次请求限制为100-200个URL，超出会报错。time.sleep(1)：防止并发请求过快被限流。- 实际使用时,需替换鉴权方式（阿里云使用HmacSHA256签名，腾讯云使用SecretKey + 时间戳）。
关键注意事项：避免踩坑
- 注意频率限制：每个CDN服务商都有每日刷新上限（如阿里云普通用户每日最多刷新1000个URL），脚本建议加入计数器，达到阈值后停止。
- 目录与文件刷新区别：刷新目录时，CDN会清除该目录下所有文件的缓存，但可能不会立即覆盖正在请求的热门资源，建议在低峰期操作。
- 使用通配符是否可行：部分CDN（如Cloudflare）支持通配符（如
*.example.com/img/*），但大多数国内的CDN只支持精确文件路径或目录路径。 - 鉴权安全：永远不要在代码中硬编码AccessKey Secret，建议使用环境变量或密钥管理服务。
问答环节：解决你最常见的5个疑问
问1：脚本刷新后，用户多久能看到新版本？ 答：取决于CDN节点和刷新任务队列，通常提交后几秒到几分钟内生效，部分大文件或冷门资源可能延迟到1小时左右。
问2：可以一次性刷新整个域名吗？
答：大多数CDN不支持直接刷新整个域名，但你可以刷新网站的根目录（如https://yourdomain.com/）来达到类似效果，注意，这会使CDN回源重新缓存所有资源，可能导致源站压力激增。
问3：脚本刷新与手动刷新有什么区别？ 答：脚本可以处理数千条URL，并集成到CI/CD流水线中（例如代码提交后自动触发刷新），手动刷新只适合少量临时操作。
问4：我会不会因为刷新导致费用增加？ 答：大部分CDN的刷新功能是免费的，但部分服务商对“预拉取”或“高频刷新”收费，请查阅你的CDN服务商计费规则。
问5：如果我刷新了URL，但用户依然看到旧内容，怎么办？
答：首先检查该URL是否真的已提交成功（某些CDN提供查询任务接口），确保你没有同时设置浏览器强缓存（如Cache-Control: max-age=31536000），如果用户浏览器缓存了该资源，即使CDN刷新，用户仍须手动清除浏览器缓存。
从手动到自动，提高运维效率
脚本批量刷新CDN缓存,是运维自动化的一个关键环节，通过本文的实战脚本和注意事项，你可以：
- 从手动逐一刷新上百个URL中解脱出来。
- 将刷新操作集成到你的DevOps流水线（如Jenkins、GitLab CI）。
- 避免因忘记刷新缓存导致的线上事故。
建议：将脚本部署到服务器，并配合一个简单的Webhook监听（例如监听GitHub代码推送事件），自动触发指定目录的刷新，这样你的网站更新流程将真正实现“秒级生效”。
