.Net Core项目调用Redis Stack时报ERR unknown command 'FT._LIST'错误求助

核心排查与解决步骤 #

1. 确认客户端连接的实例是否正确 #

你在Docker的redis-cli里能正常执行FT._LIST，但项目报错，大概率是代码连接到了非Redis Stack的实例（比如本地原生Redis服务）：

• 终端执行netstat -ano | findstr :6379（Windows）或lsof -i :6379（Linux/Mac），查看6379端口的监听进程，确认是Docker容器进程而非本地Redis；
• 在项目中添加调试代码，输出Redis服务器版本：

  using var conn = ConnectionMultiplexer.Connect("localhost:6379");
  var server = conn.GetServer("localhost:6379");
  Console.WriteLine(server.ServerVersion);
  

  正常Redis Stack的版本会带有RedisStack标识（如7.2.4 (RedisStack:7.2.4-v1)），如果输出是普通Redis版本，说明连错了实例。

2. 升级StackExchange.Redis到最新稳定版 #

旧版本的StackExchange.Redis对Redis Stack的模块命令兼容性较差：

• 打开NuGet包管理器，找到StackExchange.Redis并更新到最新稳定版；
• 若使用.NET CLI，执行命令：

  dotnet add package StackExchange.Redis --version [最新版本号]
  

3. 检查代码中命令的执行方式 #

确保代码里执行FT._LIST的语法正确：

• 正确用法示例：

  using var conn = ConnectionMultiplexer.Connect("localhost:6379");
  var db = conn.GetDatabase();
  var result = db.Execute("FT._LIST");
  // 处理返回结果
  

  避免使用封装的方法调用，直接用Execute执行原生命令。

4. 验证Docker容器的端口映射与状态 #

• 执行docker ps查看Redis Stack容器的端口映射，确认是0.0.0.0:6379->6379/tcp；
• 重启容器并验证：

  docker restart [你的Redis Stack容器ID]
  

  重启后再次用redis-cli执行FT._LIST确认命令可用，再启动项目测试。

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