Statamic静态缓存中的重定向问题解析与解决方案

问题背景

在Statamic CMS项目中，开发者在使用静态缓存功能时遇到了一个典型的重定向缓存问题。具体表现为：当系统根据用户地理位置进行页面重定向时，重定向后的页面被错误地缓存，导致后续请求无法正确返回原始页面。

问题重现

假设系统中有两个页面：

• 国际版：/party
• 欧洲版：/eu/party

当欧洲用户访问国际版页面时，系统通过中间件将其重定向到欧洲版页面。然而，当用户在欧洲版页面上点击"返回国际版"按钮时，系统仍然显示被缓存的欧洲版页面，而不是预期的国际版内容。

技术分析

这个问题源于Statamic静态缓存机制的工作方式。在默认配置下，系统会缓存所有HTTP响应，包括302重定向响应。这导致了以下问题链：

1. 首次访问国际版页面时触发重定向
2. 重定向响应被静态缓存
3. 后续请求直接返回缓存的重定向响应
4. 用户无法获取原始的国际版内容

解决方案探索

临时解决方案

开发者最初通过在ApplicationCacher中添加条件判断来解决问题，跳过对302状态码响应的缓存：

if ($event->response->getStatusCode() === 302) {
    return;
}

这种方法虽然有效，但属于直接修改核心代码，不利于长期维护和升级。

推荐解决方案

更优雅的解决方案是通过调整中间件执行顺序来确保重定向逻辑在静态缓存检查之前执行：

1. 使用中间件优先级：在Kernel.php中定义$middlewarePriority属性，确保自定义重定向中间件在静态缓存中间件之前执行

2. 动态前置中间件：在AppServiceProvider中使用router的prependMiddlewareToGroup方法，将重定向中间件前置到web中间件组

app('router')->prependMiddlewareToGroup('web', GeoRedirect::class);

配置优化建议

对于类似场景，建议在static_caching.php配置文件中进行以下优化：

1. 明确指定需要忽略缓存的URL模式
2. 配置允许的特殊查询参数（如示例中的mistake=true）
3. 考虑为不同地区版本设置不同的缓存策略

总结

Statamic的静态缓存功能虽然强大，但在处理动态重定向场景时需要特别注意。通过合理配置中间件执行顺序和缓存策略，可以既保持缓存带来的性能优势，又不牺牲系统的动态功能需求。对于需要根据用户特征（如地理位置）动态响应的场景，建议优先考虑在缓存检查前完成重定向逻辑，或者为不同用户群体设置独立的缓存版本。