最稳定做法是用 static final GenericContainer 声明 Redis 容器，在 @BeforeAll 中启动并配合 @DynamicPropertySource 注入地址，禁用 AOF、指定国内镜像、加 Redis 等待策略，并验证连接是否真实生效。
直接用 GenericContainer 启动 Redis 容器并注入 Spring Boot 测试上下文，是目前最稳定、兼容性最好的做法。别信“一行注解自动绑定”的宣传，Redis 不在 @ServiceConnection 的默认支持列表里，硬套会连错地址或 NPE。
容器必须声明为 static 字段 + @BeforeAll 启动
JUnit 5 的生命周期中，@DynamicPropertySource 方法在 Spring 上下文刷新前执行，但此时容器的 IP 和映射端口还没可用——除非你把它变成静态字段，并显式控制启动时机。
- 用
static final GenericContainer> REDIS声明，配合withReuse(true)减少重复拉镜像开销 - 在
@BeforeAll方法里调用REDIS.start()，确保它在属性注入前就位 - 避免把容器放在测试类实例字段里，否则每个测试方法都会新建容器，CI 耗时翻倍
别依赖默认 redis:latest 镜像
国内网络环境下，redis:latest 经常拉取失败或超时，日志卡在 Pulling image redis:latest，最终抛 TimeoutException。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 改用轻量且国内可直达的镜像，例如
registry.cn-hangzhou.aliyuncs.com/library/redis:7.2-alpine - 启动时禁用 AOF：
withCommand("redis-server", "--appendonly", "no")，避免因挂载卷权限问题导致容器退出 - 加等待策略：
waitingFor(Wait.forRedis())（需引入testcontainers-module-redis），比单纯等端口开放更可靠
@DynamicPropertySource 注入地址要绕过静态初始化陷阱
常见错误是写成 @DynamicPropertySource(staticMethod = "redisProperties")，而 redisProperties 里直接调用了未初始化的 REDIS.getContainerIpAddress()，结果 NPE 或返回 localhost。
- 把地址获取逻辑封装进一个静态方法，且该方法只在
REDIS已 start 后才被调用 - 示例写法：
return Map.of("spring.redis.host", REDIS.getContainerIpAddress(), "spring.redis.port", REDIS.getMappedPort(6379).toString()); - 不要在
@DynamicPropertySource的 lambda 里做任何可能触发容器未启动的操作
Spring Boot 3.2+ 可以省掉部分配置，但别全信自动装配
@ServiceConnection 在 Spring Boot 3.1+ 支持 Redis，但实际需要手动注册 RedisConnectionFactoryBean，否则 RedisTemplate 仍连本地 localhost:6379。
- 如果你用的是 Spring Boot 3.2，可以尝试
@ServiceConnection(redis)配合@Container字段，但必须确认redis是非 static 实例字段 +@Testcontainers类注解 - 更稳妥的做法仍是走
@DynamicPropertySource注入 host/port，不依赖自动装配路径 - 务必在测试里加一句
assertThat(redisTemplate.getConnectionFactory().getConnection().ping()).isEqualTo("PONG");，验证真连上了容器，不是 mock 或 fallback
最容易被忽略的一点：Testcontainers 默认找 DOCKER_HOST=https://localhost:2376，但很多 CI 环境（比如 GitHub Actions）用的是 docker://var/run/docker.sock。如果容器启动报 “connection refused”，先检查 Docker daemon 是否可达，而不是怀疑 Redis 配置。
