Django多站点多语言场景下URL解析器缓存串扰问题优化方案咨询

业务场景描述 #

项目为Django多站点架构，需适配差异化多语言规则，通过URL路径区分内容语言，且默认语言不配置独立路径前缀，具体规则如下：

• 站点1：根路径/ 对应俄语内容，/en 对应英语内容，站点默认语言为俄语
• 站点2：根路径/ 对应英语内容，/ru 对应俄语内容，站点默认语言为英语

核心适配矛盾 #

Django原生实现存在路由缓存复用问题：框架对URL解析器做全局缓存，缓存的路由前缀逻辑不会随访问站点动态变化。当不同站点配置差异化默认语言时，会出现路由匹配错误——本质原因是Django的get_resolver()函数挂载了@functools.lru_cache装饰器，缓存键仅关联项目根路由配置，未关联站点维度信息，导致某一个站点的默认语言无路由前缀规则，被错误复用到所有其他站点，引发路由匹配异常。
针对该问题的核心诉求为：寻找Django原生支持的实现方式，要么禁用该全局路由缓存，要么将缓存逻辑与站点维度绑定，避免跨站点的路由规则错配。

Django 原生路由缓存实现 #

框架自带的URL解析缓存核心代码如下：

def get_resolver(urlconf=None):
    if urlconf is None:
        urlconf = settings.ROOT_URLCONF
    return _get_cached_resolver(urlconf)


@functools.lru_cache(maxsize=None)
def _get_cached_resolver(urlconf=None):
    return URLResolver(RegexPattern(r'^/'), urlconf)

现存临时方案的局限 #

为解决上述问题，当前采用侵入式打补丁的方式修改Django核心模块逻辑，实现分站点的路由解析器缓存，代码逻辑如下：

from django.urls.resolvers import URLResolver, RegexPattern

@functools.lru_cache(maxsize=None)
def get_resolver_for_site(site_id, urlconf):
    return URLResolver(RegexPattern(r'^/'), urlconf)


def _get_cached_resolver_for_site(urlconf=None):
    return get_resolver_for_site(get_site().id, urlconf)


@receiver(post_save, sender=SiteSettings)
def clear_url_resolver_cache(sender, **kwargs):
    get_resolver_for_site.cache_clear()


resolvers._get_cached_resolver = _get_cached_resolver_for_site

该方案虽可实现按站点维度缓存URL解析器的效果，但属于非规范的hack手段，直接替换核心模块的内部函数，长期维护成本高，需寻找更合理的适配路径。

规范实现思路 #

• 不直接替换Django resolvers模块的内部函数，而是在项目的站点识别中间件层完成当前站点ID判定后，将站点ID作为缓存维度的组成部分，构建独立的分桶缓存逻辑，避免全局侵入式修改
• 利用Django原生的路由解析器扩展能力，为每个站点构建独立的URLResolver实例，将站点ID作为缓存键的必填项，当站点配置更新时仅清除对应站点的缓存条目，无需全量清空所有路由缓存
• 语言路由规则与站点绑定的逻辑下沉：在路由解析流程中，完成站点身份识别后，再加载对应站点的语言路由规则（含默认语言无前缀、其他语言带路径前缀的匹配逻辑），不依赖全局缓存的路由规则做跨站点复用
• 缓存性能优化：无需完全禁用全局路由缓存，仅需调整缓存键的组成结构，将站点ID纳入缓存判定维度，既保留路由表预构建的性能收益，又避免跨站点的规则复用错误

内容的提问来源于stack exchange，提问作者Veniamin