缓存有效期配置未生效或调用方式不匹配会导致数据长期滞留；需通过修改config/cache.php中expire值并执行php think clear:config、cache::set()显式传入正整数秒数、cache::remember()严格按序传参、store实例独立配置及动态校验ttl等五种方式精准控制。
如果您在 ThinkPHP 项目中发现缓存数据长期滞留或未按预期失效，则可能是由于缓存有效期配置未生效或调用方式不匹配。以下是配置缓存有效期的具体方法：
一、修改缓存驱动默认过期时间
全局缓存有效期由缓存驱动初始化时传入的 expire 值决定，该值在配置文件中定义，是影响绝大多数缓存写入行为的最直接方式。修改后必须清理配置缓存才能使新设置生效。
1、打开 config/cache.php 文件（ThinkPHP 6）或 application/config.php 中的 cache 节点（ThinkPHP 5）。
2、定位到 'default' => ['type' => 'redis', 'expire' => 3600] 或对应 store 配置块（如 'stores'['redis']）。
3、将 'expire' 的值修改为所需秒数，例如 1800 表示 30 分钟。
4、保存文件后，在项目根目录执行命令：php think clear:config。
二、在 Cache::set() 调用中显式指定过期时间
此方式可覆盖驱动默认值，适用于单次写入需差异化控制时效的场景。它不改变全局配置，仅作用于当前 key-value 写入操作。
1、在控制器或业务逻辑中调用 Cache::set() 方法时，必须传入第三个参数。
2、确保该参数为正整数，单位为秒，例如：Cache::set('user_1001', $data, 600) 表示缓存 10 分钟。
3、若传入 0，在 File 和 Redis 驱动下表示永不过期；在 Memcached 驱动下可能被解释为 1 秒，需实测验证。
4、禁止传入浮点数、时间戳或 DateTime 对象——除非明确知晓所用驱动支持且已充分测试，否则应统一使用 time() + 秒数 形式推算。
三、为 Cache::remember() 正确传入过期时间参数
Cache::remember() 不会自动读取配置中的 expire 值，其第二个参数即为强制必填的过期时间（单位：秒），位置错误或缺失将导致行为异常。
1、正确写法为：Cache::remember('user_1001', 3600, function () { return User::find(1001); })。
2、错误写法示例：Cache::remember('user_1001', function () { return User::find(1001); }, 3600) —— 第三个参数被忽略，实际使用驱动默认值。
3、若需复用配置值，应显式读取：config('cache.default.expire')，但须确保配置已加载且路径正确（TP5/TP6 路径不同）。
4、ThinkPHP 6.3+ 支持传 null 表示使用驱动初始化时设定的默认 expire，前提是配置中已明确定义该值。
四、通过 store 实例独立设置过期时间
当启用多缓存通道（multi-store）时，每个 store 可拥有独立的 expire 配置，互不影响。此方式适合模块化隔离缓存生命周期策略的场景。
1、在 config/cache.php 的 stores 数组中，为不同 store 显式声明 expire 字段。
2、例如为 redis 缓存单独设为 7200 秒：'redis' => ['type' => 'Redis', 'host' => '127.0.0.1', 'expire' => 7200]。
3、调用时指定 store 名称：Cache::store('redis')->set('key', 'val', 3600)，此时优先级为：调用参数 > store 配置 > default 配置。
4、若某 store 未定义 expire，则 fallback 至 default 下的 expire 值（若存在）或驱动内置默认值。
五、动态计算并校验过期时间值
在业务逻辑中根据条件推导 TTL 时，必须进行类型强转与范围校验，避免因隐式转换或超限值导致缓存立即失效或行为不可控。
1、对原始计算值执行强制整型转换：$ttl = (int) round($base * $factor)。
2、校验是否为合法正整数：is_numeric($ttl) && $ttl > 0 && floor($ttl) == $ttl。
3、针对 Redis 驱动添加上限保护：$ttl = min(2592000, $ttl)（限制最大 30 天）。
4、开发环境开启缓存调试日志：'cache' => ['debug' => true]，观察实际写入的 TTL 是否与预期一致。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
