使用os.walk()遍历缓存目录需设follow_symlinks=false、捕获permissionerror并跳过符号链接;判断过期应优先解析文件名或元数据而非硬套mtime;大量小文件删除推荐subprocess.run调用find;crontab中须指定python绝对路径及完整环境。

用 os.walk() 遍历缓存目录时要注意路径权限和符号链接
直接 os.walk() 会进入所有子目录,包括被挂载的 NFS 或容器卷,可能触发 PermissionError 或卡死。必须加异常捕获,并跳过符号链接(避免循环遍历)。
实操建议:
- 用
follow_symlinks=False参数(Python 3.12+ 默认为False,但老版本需显式指定) - 在
try...except PermissionError块中跳过无法访问的路径 - 检查
os.path.islink(),跳过符号链接目录(尤其常见于/var/cache下的 docker 或 snap 挂载点)
判断「过期」不能只看 mtime,得结合业务语义
缓存文件的“过期”不等于“最后修改时间 > N 天”,比如某些预生成的 HTML 文件是按内容哈希命名、长期有效;而临时上传的图片可能 1 小时就该删。硬写 time.time() - os.path.getmtime(path) > 86400 * 7 容易误删。
实操建议:
- 优先读取文件名中的时间戳(如
cache_202405201422.json)或解析文件头里的X-Cache-Expires注释 - 若必须用 mtime,先确认该目录下所有文件确实是「写入即生效、之后不再更新」的缓存——否则应改用 ctime 或检查文件内容更新标记
- 对日志类缓存(如
*.log.gz),用os.path.getctime()更合理,因为归档后不会改 mtime
用 subprocess.run() 调用 find 比纯 Python 删除更稳
Python 的 os.remove() + os.rmdir() 在大量小文件场景下容易触发系统级限制(如 open file limit),且不支持原子性删除空目录树。Linux 服务器上,让 find 干这事更可靠。
实操建议:
- 用
subprocess.run(['find', cache_dir, '-type', 'f', '-mtime', '+7', '-delete'], check=True)清理文件 - 再补一句
subprocess.run(['find', cache_dir, '-type', 'd', '-empty', '-delete'], check=True)清空残留空目录 - 务必加
check=True,失败时抛异常,避免静默跳过错误(比如磁盘满导致 delete 失败但脚本继续) - 别用
shell=True——cache_dir若含空格或特殊字符会出问题
crontab 里跑 Python 脚本必须指定完整路径和环境
cron 默认 PATH 很窄(通常只有 /usr/bin:/bin),找不到你 venv 里的 Python,也加载不了 ~/.bashrc 里的环境变量,结果脚本报 ModuleNotFoundError 或连 import os 都失败。
实操建议:
- crontab 条目写成:
0 3 * * * /usr/bin/python3 /opt/scripts/clean_cache.py >> /var/log/clean_cache.log 2>&1 - 脚本开头加
#!/usr/bin/env python3不起作用 —— cron 不读 shebang,必须显式调用解释器 - 如果依赖虚拟环境,直接用
/opt/venv/bin/python3而不是source activate(cron 不启动 shell) - 在脚本里打印
os.environ.get('PATH')和sys.executable,第一次运行时查日志确认执行环境
实际部署时最容易被忽略的是:缓存目录本身可能被多个服务同时写入(如 nginx 缓存 + 应用层缓存混存),删一半可能让某个服务崩溃。上线前务必用 --dry-run 模式跑一次,把待删列表输出到文件人工核对。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











