Nginx Log 排查问题的意外发现：从 30% 304 比例到不到 1%，始作俑者竟然是本地 cache 混用！

304 优化之旅：从原理到实践，再到突发失效

304 优化：从了解原理到实践落地

作为一名开发人员，我们经常需要优化 API 性能以提供更好的用户体验。一种有效的方法是实现 304 优化，它允许服务器在客户端已缓存资源的情况下返回 304（未修改）状态码，从而避免不必要的下载。

什么是 304？

304 是一个 HTTP 状态码，表示客户端请求的资源与服务器上现有的资源完全一致。在这种情况下，服务器会返回 304 状态码，指示客户端直接使用其缓存的资源，而无需重新下载。

304 优化的优点

304 优化的好处包括：

• 降低服务器带宽消耗： 客户端不再需要从服务器下载资源，从而减轻服务器的负载。
• 提高服务器性能： 服务器处理 304 请求比处理完整下载请求所需的资源更少。
• 减少客户端请求时间： 客户端可以立即使用缓存的资源，从而减少请求延迟。

304 优化的实践

在实践中，可以使用多种方法实现 304 优化。最常见的方法之一是使用缓存。缓存可以将请求的资源存储起来，以便下次请求时直接从缓存中读取，而无需重新请求服务器。

在 nginx 等 Web 服务器中，可以使用代理缓存模块实现缓存。例如，以下 nginx 配置启用代理缓存：

location /api {
    proxy_cache my_cache;
    proxy_cache_revalidate on;
    proxy_cache_use_stale error timeout invalid_header http_500 http_502 http_503 http_504;
}

304 优化后取得的成果

在对我们的主页列表 API 进行 304 优化后，我们观察到了显著的改进。304 比例从不到 1% 飙升至 30% 以上，表明优化非常成功。

突发失效：从问题发现到根源追踪

然而，在优化之后的一段时间里，我们发现主页列表 API 的 304 比例又从 30% 以上暴跌至不到 1%。这让我们感到疑惑，因为我们并没有对代码进行任何修改。

经过一番排查，我们找到了问题的根源：本地缓存混用。在我们的代码中，我们使用了一个第三方库来处理缓存，这个库默认使用本地缓存，而我们并没有意识到这一点。

当我们同时使用第三方库的缓存和 nginx 的缓存时，就会导致本地缓存混用。这会导致 nginx 缓存失效，从而导致 304 比例暴跌。

解决方案

为了解决这个问题，我们修改了第三方库的配置，让其不再使用本地缓存。这样，我们就避免了本地缓存混用，304 比例也恢复到了正常水平。

总结：从问题解决到经验总结

通过这次问题的排查，我们总结了几点经验教训：

• 在进行 304 优化时，需要充分考虑各种因素，包括本地缓存的使用情况。
• 在使用第三方库时，需要仔细阅读文档，了解其缓存机制。
• 在遇到问题时，不要气馁，要保持耐心，一步一步排查，终能找到问题的根源。

希望这篇文章能对您有所帮助。如果您有任何问题，欢迎在评论区留言，我会尽快回复。

常见问题解答

1. 什么是本地缓存混用？

本地缓存混用是指同时使用多个缓存机制的情况，从而导致缓存失效。

2. 如何避免本地缓存混用？

要避免本地缓存混用，请确保只使用一种缓存机制，或者确保不同的缓存机制不会相互干扰。

3. 什么是 ETag？

ETag（实体标记）是一个唯一的标识符，用于标识服务器上的资源版本。客户端在请求资源时可以发送 ETag，服务器可以使用它来检查资源是否已被修改。

4. 什么是 Last-Modified？

Last-Modified 是一个 HTTP 头，指示资源上次被修改的时间。客户端在请求资源时可以发送 Last-Modified，服务器可以使用它来检查资源是否已被修改。

5. 如何启用 304 优化？

在 nginx 中，可以通过启用代理缓存模块来启用 304 优化。您可以在 nginx 配置文件中使用以下指令：

proxy_cache my_cache;