Golang如何用testcontainers测试_Golang testcontainers教程【完整】-Golang-PHP中文网

PostgreSQL容器连不上主因是端口映射与就绪检查未配对：需显式配置ExposedPorts、用wait.ForListeningPort校验就绪、连接串加sslmode=disable、动态取MappedPort、defer container.Terminate(ctx)清理。

golang如何用testcontainers测试_golang testcontainers教程【完整】

直接用 localhost:5432 去连 testcontainers 启的 PostgreSQL，几乎必失败——不是 Docker 没起来，而是容器 IP 和端口映射、服务启动时序全没对上。

ExposedPorts 必须显式写 []string{"5432/tcp"}，否则 Docker 不做端口映射，MappedPort 返回空
WaitingFor 不能省，更不能只靠 time.Sleep：PostgreSQL 日志里出现 database system is ready to accept connections 才算真就绪，推荐用 wait.ForListeningPort("5432/tcp")
连接字符串里漏掉 sslmode=disable 会导致 dial error 或 context timeout，因为默认启用了 SSL 但容器没配证书
别硬写端口，用 container.MappedPort(ctx, "5432") 动态取宿主机分配的真实端口

CI 跑几次就提示端口被占用、本地 docker ps 一堆 testcontainers-go-xxx 僵尸容器，根本原因不是忘了清理，而是清理方式错了。

必须用 defer container.Terminate(ctx)，不是 Stop()，也不是手动 Remove()
Terminate() 默认会等 10 秒 graceful shutdown，再强制 kill；而 Stop() 立即返回，不等进程退出，后续 Terminate() 实际无动作
多个容器时，别在 TestMain 里统一 Terminate 所有——万一某个容器启动失败，container 是 nil，Terminate() panic；每个测试内单独 defer 更稳
Linux 下若看到 failed to dial docker endpoint，先确认用户是否在 docker 组：sudo usermod -aG docker $USER，然后重开终端

你把 .sql 文件挂进 /docker-entrypoint-initdb.d/，但每次测试都跳过执行——PostgreSQL 只在空数据目录首次启动时才运行 init 脚本。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

testcontainers 默认创建匿名 volume，容器删了，volume 还在；下次同镜像再起，它发现 /var/lib/postgresql/data 非空，直接跳过 init
最简单解法：每次测试前确保 container.Terminate(ctx) 成功执行，它会一并删掉关联的匿名 volume
不想依赖 volume 生命周期？改用 ContainerRequest.Files 把 SQL 内容直接写入容器路径，绕过挂载逻辑
验证是否生效：容器启动后 docker exec -it <id> ls -l /docker-entrypoint-initdb.d/</id>，再 psql -U test -c '\dt' 查表

Go 测试里 client.Set() 返回 nil，但紧接着 client.Get() 就返回空，大概率不是 Redis 没存，而是 client 行为或连接状态干扰了结果。

redis.Client 默认启用 pipeline 和连接复用，一次 Set 可能还没刷到服务端就被 Get 截获了旧连接
初始化 client 时加 DisableIndentity: true 关 pipeline（注意拼写是 DisableIndentity，非 Identity），或显式等写入完成：client.Set(ctx, "k", "v", 0).Err()
读操作前加 time.Sleep(10 * time.Millisecond) 仅用于调试；生产级应改用 client.Wait(ctx, 1, 100*time.Millisecond) 等副本同步（如果启了 replica）
容器内 Redis 默认只监听 127.0.0.1，宿主机连不上；启动时加 Cmd: []string{"redis-server", "--bind", "0.0.0.0:6379", "--port", "6379"}