如何提升Redis向量索引服务器限制以处理超24.5万文档？

核心原因 #

这个错误是Redis向量索引（如RediSearch/RedisStack中的HNSW索引）的初始容量设置，超过了服务器根据当前内存、向量维度等参数计算出的上限。单纯增加Docker容器资源无法解决，需要调整索引参数或Redis配置。

具体解决方法 #

1. 取消或降低索引初始容量设置 #

创建索引时不要硬设过高的CAPACITY值，让Redis自动动态扩容。

• 错误示例（硬设过高容量）：

FT.CREATE idx ON HASH PREFIX 1 doc: SCHEMA vec VECTOR HNSW 6 DIM 1536 CAPACITY 245364

• 修改后（不指定容量或设为低于限制的值）：

FT.CREATE idx ON HASH PREFIX 1 doc: SCHEMA vec VECTOR HNSW 6 DIM 1536

2. 调整HNSW索引的M参数 #

HNSW的M参数（每层邻居数）直接影响内存占用，降低M可提升服务器支持的最大初始容量。比如将M从6降至4：

FT.CREATE idx ON HASH PREFIX 1 doc: SCHEMA vec VECTOR HNSW 4 DIM 1536 CAPACITY 245364

M值越小，索引内存开销越低，相同资源下可承载更多文档。

3. 优化Redis内存配置 #

确保Docker容器分配足够内存，同时调整Redis内存策略：

• 启动Docker时指定内存限制（根据服务器实际资源调整）：

docker run -d --name redis-stack -p 6379:6379 -p 8001:8001 redis/redis-stack:latest --maxmemory 16g --maxmemory-policy allkeys-lru

4. 分片存储（超大规模数据场景） #

若文档量远超单实例承载上限，可使用Redis Cluster做分片，将向量数据分散到多个节点，避免单节点容量超限。

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