如何成功将Django连接到Azure Cache for Redis并解决URL格式报错？

核心问题 #

你当前的LOCATION参数格式不符合django-redis的要求——不能用逗号拼接额外参数（如ssl=True、abortConnect=False），这些参数需要单独放到OPTIONS配置中，或者使用带SSL的Redis协议rediss://。

正确配置示例 #

方式1：使用rediss://协议（推荐，直接适配SSL要求） #

CACHES = {
    "default": {  
        "BACKEND": "django_redis.cache.RedisCache",
        # 用rediss://协议，密码嵌入URL，端口固定为6380
        "LOCATION": f"rediss://:{secrets.AZURE_REDIS_PASSWORD}@<my_redis_service_name>.redis.cache.windows.net:6380/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
            # 可选：配置连接超时与中断检测
            "CONNECTION_POOL_KWARGS": {
                "socket_connect_timeout": 5,
                "socket_timeout": 5,
                "abort_connect": False
            }
        },
    }
}  

方式2：用redis://协议，在OPTIONS中单独配置SSL #

CACHES = {
    "default": {  
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": f"redis://<my_redis_service_name>.redis.cache.windows.net:6380/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
            "PASSWORD": secrets.AZURE_REDIS_PASSWORD,
            "SSL": True,
            "CONNECTION_POOL_KWARGS": {
                "abort_connect": False
            }
        },
    }
}  

关键注意点 #

• 协议要求：Azure Cache for Redis强制SSL连接，要么用rediss://协议（默认启用SSL），要么在OPTIONS中显式设置SSL=True。
• URL规范：标准Redis URL格式为[redis[s]://][:password@]host:port/db，额外参数不能用逗号拼接，需放入CONNECTION_POOL_KWARGS。
• 版本兼容：确认django-redis（jazzband包）版本适配Django 4.0.7，建议升级至5.2.0+的兼容版本。
• 验证步骤：
  • 核对Redis服务名称、密码的准确性，若密码含特殊字符需做URL编码。
  • 确认Azure Redis防火墙规则已将VM公网IP加入允许列表。
  • 在VM上用redis-cli测试连接：redis-cli -h <my_redis_service_name>.redis.cache.windows.net -p 6380 -a <password> --ssl，能正常连接再配置Django。

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