django-redis无效数据库索引错误及Redis URL含义咨询

错误原因分析 #

你遇到的"invalid DB index"错误，通常有两种常见诱因：

• Redis实例数据库数量限制：Redis默认配置了16个逻辑数据库（索引从0到15），但如果你的Redis配置文件（redis.conf）里修改了databases参数，比如设为1，那只能使用索引0，此时指定/1就会超出允许范围，触发错误。
• URL中数据库索引格式错误：如果URL里的数据库部分不是合法的非负整数（比如写了/abc、/-1），也会导致这个错误。不过你用的是官方示例的/1，这种概率较低，但可以检查下是否有拼写错误。

Redis URL各部分含义拆解 #

以你使用的redis://127.0.0.1:6379/1为例，每个部分的作用清晰明确：

• redis://：协议前缀，表明使用标准的Redis TCP连接方式，还有rediss://这类协议用于SSL加密连接场景
• 127.0.0.1：Redis服务器的IP地址，这里是本地回环地址，若连接远程Redis则替换为对应服务器IP
• 6379：Redis服务默认监听的TCP端口号，若你的Redis修改过端口配置，这里要同步调整
• /1：指定要使用的Redis逻辑数据库索引，Redis通过数字索引区分不同的逻辑数据库，默认使用索引0，多个数据库之间数据相互隔离，适合不同业务场景的缓存存储

快速排查建议 #

1. 打开你的Redis配置文件，查找databases参数，确认值大于等于2（因为你要使用索引1），修改后重启Redis服务。
2. 暂时把LOCATION改成redis://127.0.0.1:6379/0测试，如果能正常使用，就说明是数据库数量配置的问题。
3. 检查URL是否有多余符号或拼写错误，比如是否误写成redis://127.0.0.1:6379//1（多了一个斜杠）。

内容的提问来源于stack exchange，提问作者David Foie Gras