Spring单元测试用嵌入Redis时触发'GEOADD'未知命令错误

这个错误很典型——你用的嵌入式Redis实现没有支持GEO系列命令（Redis 3.2版本才正式引入GEO功能）。大多数轻量嵌入式Redis库都是为测试基础键值操作设计的，并没有实现Redis的全部高级特性，GEO就是其中一个经常被忽略的部分。

下面给你两个靠谱的解决方案，按推荐优先级排序：

方案1：用Testcontainers启动真实Redis容器（推荐） #

Testcontainers会在测试时启动一个真实的Redis Docker容器，完全支持所有Redis命令，和生产环境的行为完全一致，测试结果更可信。

步骤： #

1. 添加Testcontainers Redis依赖到你的构建文件：

   • Maven（pom.xml）：

     <dependency>
         <groupId>org.testcontainers</groupId>
         <artifactId>redis</artifactId>
         <scope>test</scope>
     </dependency>
     <dependency>
         <groupId>org.testcontainers</groupId>
         <artifactId>junit-jupiter</artifactId>
         <scope>test</scope>
     </dependency>
     

   • Gradle（build.gradle）：

     testImplementation 'org.testcontainers:redis'
     testImplementation 'org.testcontainers:junit-jupiter'
     

2. 在测试类中配置Redis容器，让Spring连接到这个容器：

   @SpringBootTest
   @Testcontainers
   public class GeoLocationTest {
   
       // 启动Redis 7.0容器（可以根据需要指定版本）
       @Container
       private static final RedisContainer redisContainer = new RedisContainer(DockerImageName.parse("redis:7.0"))
               .withExposedPorts(6379);
   
       // 动态覆盖Spring的Redis配置
       @DynamicPropertySource
       static void configureRedisProperties(DynamicPropertyRegistry registry) {
           registry.add("spring.data.redis.host", redisContainer::getHost);
           registry.add("spring.data.redis.port", redisContainer::getFirstMappedPort);
       }
   
       // 注入RedisTemplate或者你的Geo操作类
       @Autowired
       private RedisTemplate<String, Point> redisTemplate;
   
       @Test
       void testGeoAddAndRadiusQuery() {
           // 执行GEOADD操作，现在不会报错了
           redisTemplate.opsForGeo().add("locations", new Point(116.397428, 39.90923), "beijing");
           // 筛选25公里范围内的位置
           GeoResults<GeoLocation<String>> results = redisTemplate.opsForGeo()
                   .radius("locations", new Circle(new Point(0, 0), new Distance(25, Metrics.KILOMETERS)));
           // 断言结果
           assertNotNull(results);
       }
   }
   

方案2：使用支持GEO命令的嵌入式Redis库 #

如果你不想用Docker/Testcontainers，可以选择一个能启动真实Redis进程的嵌入式库，比如it.ozimov:embedded-redis，它可以指定Redis版本（必须选3.2及以上）。

步骤： #

1. 添加依赖：

   <dependency>
       <groupId>it.ozimov</groupId>
       <artifactId>embedded-redis</artifactId>
       <version>0.7.3</version>
       <scope>test</scope>
   </dependency>
   

2. 在测试类中启动指定版本的Redis服务器：

   @SpringBootTest
   public class GeoLocationTest {
   
       private RedisServer redisServer;
   
       @BeforeEach
       void setUp() throws IOException {
           // 指定Redis版本为7.0.11，确保支持GEO命令
           redisServer = new RedisServer(RedisDownloader.getRedisExecutable(RedisVersion.V7_0_11), 6379);
           redisServer.start();
       }
   
       @AfterEach
       void tearDown() {
           redisServer.stop();
       }
   
       // 你的测试方法...
   }
   

注意事项： #

• 不要使用Spring Boot默认的spring-boot-starter-data-redis-test里的嵌入式Redis，它的模拟实现不支持GEO命令。
• 嵌入式Redis库虽然不需要Docker，但可能在不同操作系统上有兼容性问题，而Testcontainers的方案跨平台性更好。

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