ZigZap项目中处理静态资源缓存问题的解决方案

问题背景

在使用ZigZap框架开发Web应用时，开发者经常会遇到静态资源（如CSS和JavaScript文件）在浏览器端缓存导致无法及时更新的问题。当开发者修改了这些文件并重启服务器后，浏览器可能仍然使用旧版本的资源文件，影响开发效率和调试体验。

问题分析

ZigZap框架的sendFile方法和public_folder特性默认会为静态资源设置1小时的缓存时间。这是通过以下两种机制实现的：

1. 当使用sendFile方法直接发送文件时，框架会自动设置last-modified和cache-control头部，默认缓存时间为1小时
2. 使用public_folder功能时，所有静态资源文件都会被浏览器缓存1小时

这种缓存机制在生产环境中是有益的，可以减少服务器负载并提高用户体验。但在开发环境中，频繁修改资源文件时就会造成不便。

解决方案

方法一：在请求处理中手动设置缓存控制头

开发者可以在自定义请求处理函数中显式地设置Cache-Control头部来覆盖默认值：

fn on_request(r: zap.Request) void {
    r.setHeader("Cache-Control", "no-cache");
    r.sendFile("styles.css") catch return;
}

这种方法提供了最大的灵活性，开发者可以根据不同文件类型或环境设置不同的缓存策略。

方法二：完全控制静态资源服务

建议开发者避免过度依赖public_folder特性，而是为每个静态资源文件编写专门的处理函数：

fn serve_css(r: zap.Request) void {
    r.setHeader("Content-Type", "text/css");
    r.setHeader("Cache-Control", "no-cache");
    r.sendFile("styles.css") catch return;
}

fn serve_js(r: zap.Request) void {
    r.setHeader("Content-Type", "application/javascript");
    r.setHeader("Cache-Control", "no-cache");
    r.sendFile("script.js") catch return;
}

这种方式虽然需要编写更多代码，但提供了对资源服务的完全控制权。

方法三：开发期间禁用浏览器缓存

对于开发环境，最简单的解决方案是在浏览器开发者工具中禁用缓存：

1. 打开浏览器开发者工具（通常按F12）
2. 在"网络"或"Network"选项卡中勾选"禁用缓存"或"Disable cache"选项

这种方法不需要修改任何代码，适合快速开发和调试阶段。

最佳实践建议

1. 开发环境：使用no-cache或max-age=0的缓存策略，或者直接禁用浏览器缓存
2. 测试环境：可以考虑使用较短的缓存时间（如max-age=60）来平衡开发效率和性能
3. 生产环境：保留默认的1小时缓存，并为静态资源添加版本号或哈希值以实现长期缓存

通过合理配置缓存策略，开发者可以在不同环境中获得最佳的工作效率和用户体验。