ThinkPHP 5.1 默认不支持分布式缓存集群的自动同步清理，各节点缓存隔离导致清理不同步；推荐统一使用Redis并集中配置，配合标签化缓存与精准清除，避免全量FLUSHDB。
ThinkPHP 5.1 本身不原生支持分布式缓存集群的自动同步清理，它默认将缓存视为单节点本地资源。当部署在多服务器（如 Nginx + 多台 PHP-FPM 节点）构成的集群中，各节点各自维护独立的文件缓存（runtime/cache/）或独立连接 Redis 实例时，调用 Cache::clear() 或 php think clear 只会影响当前执行命令的那台机器，其他节点缓存仍存在——这会导致数据不一致、页面显示陈旧等问题。
核心问题：缓存不同步，清理不广播
根本原因在于 TP5.1 的缓存设计是“驱动隔离、无跨节点通知机制”：
- File 驱动：每台服务器写自己的
runtime/cache/，彼此完全物理隔离； - Redis 驱动：即使共用同一个 Redis 实例，
Cache::clear()默认执行FLUSHDB，只清该连接配置所指向的 DB，但若各节点使用了不同 DB 编号（如'database' => 0和'database' => 1），清理就无法覆盖全部； - 没有内置的“广播式清理”或“中心化缓存管理”能力，也无 Webhook、消息队列等触发机制。
推荐方案：统一使用 Redis 并集中控制
这是最实用、低侵入、易落地的方式：
- 所有节点配置相同的 Redis 连接参数（host、port、auth、database），确保
Cache::get()/set()操作都打到同一个实例； - 清理时，在任意一台节点执行
php think clear --cache（TP5.1.14+ 支持），它会触发 Redis 驱动的flush()，清空该 DB 全部键； - 若需保留部分缓存（如配置类、路由），改用带标签的缓存：
Cache::tag('user')->set('info', $data)，再通过Cache::clear('user')精准清除，避免误伤； - 务必在
config/cache.php中显式指定'type' => 'redis'及完整连接项，TP5.1 不读取app.php中的缓存配置。
补充策略：脚本轮询或 API 触发
若因架构限制必须用 File 缓存，或 Redis 各节点连不同实例，则需外部协调：
立即学习“PHP免费学习笔记（深入）”；
- 编写 Shell 脚本，用
ssh登录每台服务器，依次执行php /path/to/think clear --cache； - 在后台提供一个管理接口（如
/admin/clear-all-cache），登录后调用该接口，由控制器遍历预设的节点 IP 列表，用cURL或file_get_contents触发各节点上的清理动作（需各节点开放对应 API 且做权限校验）； - 借助 Consul、etcd 等服务发现工具，将“缓存失效信号”作为 KV 写入，各节点定时轮询该 key 变更并主动清本地缓存（适合高一致性要求场景）。
关键避坑提醒
这些细节常被忽略，却直接决定清理是否真正生效：
-
不要依赖
Cache::clear()清理文件缓存：它只清内存中已加载的键名映射，磁盘上残留的runtime/cache/xx/xx.php文件不会被删除； -
模板缓存（
runtime/view/）和路由缓存（runtime/route/）不在--cache范围内，需额外加-t或-r参数，否则前端可能看到旧模板或 404； -
生产环境禁用
FLUSHDB类全量操作：建议始终用缓存标签 +Cache::clear('tag_name')，避免影响其他业务模块； -
检查
config/cache.php是否被正确加载：TP5.1 若该文件缺失或返回非数组，Cache::set()会静默失败，清理自然无效。
