redis容器启动失败主因是镜像拉取超时或网络配置不当；应指定国内镜像、禁用aof、用wait.forredis()等待、static声明容器、通过getcontaineripaddress()获取地址，并避免@dynamicpropertysource提前执行。
Redis 容器启动失败：Testcontainers 找不到镜像或拉取超时
Testcontainers 默认会尝试拉取 redis:latest，但国内网络常导致超时或镜像不可达，表现为 TimeoutException 或日志里反复出现 Pulling image 卡住。
实操建议：
- 显式指定国内可用镜像，比如
redis:7.2-alpine（轻量、更新快），并提前用 Docker CLI 验证能否拉取：docker pull registry.cn-hangzhou.aliyuncs.com/library/redis:7.2-alpine - 在容器构建时通过
withClasspathResourceMapping()或withCommand()控制启动参数，避免默认配置触发 Redis 的 AOF 持久化（测试中不需要，且可能因挂载卷权限失败） - 设置合理等待策略，别只依赖
withReadyChecker：用waitingFor(Wait.forRedis())（需引入testcontainers-module-redis）比单纯等端口开放更可靠
Spring Boot 测试中 @Testcontainers 与 @DynamicPropertySource 冲突
常见现象是 Redis 容器已启动，但 @DynamicPropertySource 注入的 spring.redis.host 仍是 localhost，导致测试连到本地而非容器实例。
原因在于 Spring 的属性源加载顺序：静态 @DynamicPropertySource 方法在容器启动前执行，而 Testcontainers 的生命周期钩子（如 @Container 静态字段）虽早，但 IP 地址要等容器真正运行后才可获取。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- 把容器声明为
static字段，并用@BeforeAll启动（JUnit 5），再在@DynamicPropertySource中调用redis.getContainerIpAddress()和redis.getMappedPort(6379) - 避免在
@DynamicPropertySource里直接写表达式，改用 lambda 引用已初始化的容器变量，否则可能触发 NPE - 如果用的是 Spring Boot 3.1+，可考虑
@ServiceConnection注解自动绑定，但要注意它仅支持部分数据库，Redis 需手动注册RedisConnectionFactoryBean
容器间网络不通：Spring Boot 应用连不上 Testcontainers Redis
本地跑测试时一切正常，CI 环境（如 GitHub Actions）却报 Connection refused，根本原因是 Docker 默认网络模式下，宿主机进程（JVM）和容器属于不同网络命名空间，localhost 在容器内不指向宿主机。
关键点：不是“怎么让应用连 Redis”，而是“怎么让 JVM 进程访问容器的 Redis 端口”。
实操建议：
- 永远用
redis.getContainerIpAddress()+redis.getMappedPort(6379)构造连接地址，不要拼localhost:6379 - CI 环境若用 Docker-in-Docker（DinD），确保 Testcontainers 配置了
dockerHost = "tcp://host.docker.internal:2375"（GitHub Actions 支持该 DNS 名） - 禁用 Redis 的
bind 127.0.0.1（默认配置），否则容器内 Redis 只监听回环地址；可通过withCommand("redis-server --bind 0.0.0.0:6379 --port 6379")覆盖
JUnit 5 生命周期管理不当导致容器重复启停
每个测试方法都新建一个 GenericContainer 实例，结果跑 20 个 test，Redis 容器被拉起 20 次——慢、占资源、还可能因端口冲突失败。
根本矛盾在于：Redis 是无状态服务，测试间无需隔离；但 JUnit 默认按方法粒度执行生命周期。
实操建议：
- 容器必须声明为
static字段，并配合@Container+start = true（Testcontainers 1.19+），让整个测试类共享一个实例 - 避免在
@BeforeEach里调用redis.start()—— 它已经由 Testcontainers 自动管理；重复调用会抛IllegalStateException: Container is already started - 如果测试类之间需要独立 Redis 状态（比如 flushDB），不要重启容器，改用
redis.execInContainer("redis-cli", "flushall")，快且干净
最易被忽略的是容器健康检查的粒度：默认只看端口通不通，但 Redis 可能已监听却卡在加载 RDB。加一行 waitingFor(Wait.forLogMessage(".*Ready to accept connections.*", 1)) 才算真正就绪。
