为何Django未启用指定缓存后端？技术排查求助

我尝试将Django默认缓存后端从django.core.cache.backends.locmem.LocMemCache替换为其他后端：

• 先使用了django-bmemcached提供的django_bmemcached.memcached.BMemcached后端，配置了带认证的Memcached实例访问
• 后来换成Django官方支持的django.core.cache.backends.memcached.PyMemcacheCache

两种配置都在settings.py中正确定义（已确认settings.CACHES加载了配置），但实际调用caches['default']时返回的还是LocMemCache实例。直接实例化后端客户端（如bmemcached.Client）可以正常访问Memcached，排除了服务端连接问题。

需要排查为什么Django不使用配置的缓存后端，而是静默回退到默认内存缓存？

排查思路 #

1. 确认配置加载时机 #

Django的caches是单例模式，如果在settings完全加载前就调用了缓存实例，会导致Django用默认配置初始化缓存，后续即使settings更新，缓存实例也不会重新加载。

• 可以在调用caches['default']前执行from django.conf import settings; print(settings.configured())，确认输出为True（表示settings已加载完成）。
• 检查是否有模块级别的代码（比如在models.py、views.py的顶部）提前导入并使用了cache，这种情况会触发缓存提前初始化。

2. 捕获后端初始化异常 #

Django会在缓存后端初始化失败时静默回退到LocMemCache，需要手动捕获异常来定位问题：

# 在Django shell中执行
from django.conf import settings

# 测试bmemcached后端
try:
    from django_bmemcached.memcached import BMemcached
    cache = BMemcached('default', settings.CACHES['default'])
    print("初始化成功")
except Exception as e:
    print(f"初始化失败: {str(e)}")

# 测试PyMemcacheCache后端
try:
    from django.core.cache.backends.memcached import PyMemcacheCache
    cache = PyMemcacheCache('default', settings.CACHES['default'])
    print("初始化成功")
except Exception as e:
    print(f"初始化失败: {str(e)}")

常见异常原因：依赖包版本不兼容、配置参数格式错误、网络连接超时（但你直接实例化客户端正常，可能是Django后端的参数处理问题）。

3. 检查配置细节 #

• BMemcached配置：LOCATION可以是单个字符串（如'ip:port'）或字符串列表（如['ip1:port1', 'ip2:port2']），确保格式正确；OPTIONS中的username和password参数是否被后端正确识别。
• PyMemcacheCache配置：认证参数需要嵌套在server_args中，正确格式如下：

CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.memcached.PyMemcacheCache',
        'LOCATION': 'ip:port',
        'OPTIONS': {
            'server_args': {
                'username': '你的用户名',
                'password': '你的密码'
            }
        }
    }
}

4. 重启进程验证 #

由于caches是单例，一旦错误的缓存实例被初始化，会一直存在于进程内存中。必须重启Django服务或shell会话，确保新配置生效。

5. 确认配置未被篡改 #

在调用caches['default']前再次打印settings.CACHES，确认配置没有被中间件、信号或其他运行时代码修改。比如某些第三方库可能会动态修改缓存配置。

6. 验证实际缓存操作 #

不要仅依赖实例打印结果，执行实际缓存操作验证：

from django.core.cache import cache
cache.set('test_key', 'test_value', timeout=300)
# 然后用Memcached客户端（如memcached-cli）连接服务端，检查是否存在test_key

如果Memcached中能查到key，说明实例打印可能有误导（但这种情况极少），否则说明确实没有使用配置的后端。

内容的提问来源于stack exchange，提问作者Stéphan van Biljon