淺談Django 頁面緩存的cache_key是如何生成的

@cache_page(time_out, key_prefix=key_prefix)
def my_view():
 ...

class UpdateCacheMiddleware(MiddlewareMixin):
 def process_response(self, request, response):
  """Sets the cache, if needed."""
  ...
  if timeout and response.status_code == 200:
   # 根據請求和響應參數、設定的key_prefix生成頁面緩存的key
   cache_key = learn_cache_key(request, response, timeout, self.key_prefix, cache=self.cache)
   self.cache.set(cache_key, response, timeout)
  return response

# django/middleware/cache.py
class FetchFromCacheMiddleware(MiddlewareMixin):
 def process_request(self, request):
  """
  Checks whether the page is already cached and returns the cached
  version if available.
  """
  # 隻對方法為 GET 或 HEAD 的請求獲取緩存
  if request.method not in ('GET', 'HEAD'):
   request._cache_update_cache = False
   return None # Don't bother checking the cache.

  # try and get the cached GET response
  # 這裡會根據請求的信息、緩存鍵前綴生成一個cache_key。默認情況下，訪問同一個接口其cache_key應該相同
  cache_key = get_cache_key(request, self.key_prefix, 'GET', cache=self.cache)
  if cache_key is None:
   request._cache_update_cache = True
   return None # No cache information available, need to rebuild.
  # 如果獲取到response，則直接返回緩存的response，那麼實際的視圖就不會被執行
  response = self.cache.get(cache_key)
  # if it wasn't found and we are looking for a HEAD, try looking just for that
  if response is None and request.method == 'HEAD':
   cache_key = get_cache_key(request, self.key_prefix, 'HEAD', cache=self.cache)
   response = self.cache.get(cache_key)

  if response is None:
   # 如果沒有獲取到緩存，將返回None，則會執行到實際的視圖，並且重建緩存
   request._cache_update_cache = True
   return None # No cache information available, need to rebuild.

  # hit, return cached response
  request._cache_update_cache = False
  return response

# django/utils/cache.py
def learn_cache_key(request, response, cache_timeout=None, key_prefix=None, cache=None):
 # 見下文，這個cache_key由 request的完整url 以及 key_prefix 唯一確定
 cache_key = _generate_cache_header_key(key_prefix, request)
 if cache is None:
  # cache 是一個緩存實例
  cache = caches[settings.CACHE_MIDDLEWARE_ALIAS]
 # Vary 是一個HTTP響應頭字段。其內容是一個或多個http頭部名稱
 # 比如 `Vary: User-Agent` 表示此響應根據請求頭 `User-Agent` 的值有所不同
 # 隻有當下一個請求的 `User-Agent` 值與當前請求相同時，才會使用當前響應的緩存
 if response.has_header('Vary'):
  headerlist = []
  for header in cc_delim_re.split(response['Vary']):
   # 將 Vary 中出現的 http頭部名稱 加到 headerlist 中去
   header = header.upper().replace('-', '_')
   headerlist.append('HTTP_' + header)
  headerlist.sort()
  # 當前 cache_key 實際上是 cache_header_key，它存的是響應頭中Vary字段的值
  cache.set(cache_key, headerlist, cache_timeout)
  # 這裡返回的才是頁面內容對應的 cache_key，它由 
  # 出現在Vary字段中的request請求頭字段的值(有序拼在一起)、request的完整url、request的method、key_prefix 唯一確定
  return _generate_cache_key(request, request.method, headerlist, key_prefix)
 else:
  # if there is no Vary header, we still need a cache key
  # for the request.build_absolute_uri()
  cache.set(cache_key, [], cache_timeout)
  return _generate_cache_key(request, request.method, [], key_prefix)

def _generate_cache_header_key(key_prefix, request):
 """Returns a cache key for the header cache."""
 # request.build_absolute_uri()返回的是完整的請求URL。如 http://127.0.0.1:8000/api/leaflet/filterList?a=1
 # 因此，請求同一個接口，但是接口參數不同，會生成兩個cache_key
 url = hashlib.md5(force_bytes(iri_to_uri(request.build_absolute_uri())))
 cache_key = 'views.decorators.cache.cache_header.%s.%s' % (
  key_prefix, url.hexdigest())
 return _i18n_cache_key_suffix(request, cache_key)

def _generate_cache_key(request, method, headerlist, key_prefix):
 """Returns a cache key from the headers given in the header list."""
 ctx = hashlib.md5()
 # headerlist是響應頭中Vary字段的值
 for header in headerlist:
  # 出現在Vary字段中的request請求頭字段的值
  value = request.META.get(header)
  if value is not None:
   ctx.update(force_bytes(value))
 url = hashlib.md5(force_bytes(iri_to_uri(request.build_absolute_uri())))
 cache_key = 'views.decorators.cache.cache_page.%s.%s.%s.%s' % (
  key_prefix, method, url.hexdigest(), ctx.hexdigest())
 return _i18n_cache_key_suffix(request, cache_key)
​ 再看獲取緩存的get_cache_key方法

def get_cache_key(request, key_prefix=None, method='GET', cache=None):
 # 由 request的完整url 以及 key_prefix 生成 cache_header_key
 cache_key = _generate_cache_header_key(key_prefix, request)
 # headerlist是之前緩存的 與當前請求具有相同cache_header_key 的請求的響應的響應頭中Vary字段的值
 headerlist = cache.get(cache_key)
 # 即使響應頭沒有Vary字段，還是會針對當前 cache_header_key 存一個空數組
 # 因此如果headerlist為None，表示當前請求沒有緩存
 if headerlist is not None:
  # 根據 出現在Vary字段中的request請求頭字段的值(有序拼在一起)、request的完整url、request的method、key_prefix 生成 cache_key
  return _generate_cache_key(request, method, headerlist, key_prefix)
 else:
  return None