结论先说
- 纯 Mock 单元测试测不出数据库约束、索引锁和 Redis TTL 行为,核心链路必须配真实容器集成测试。用独立的
compose.test.yml拉起轻量 Postgres 与 Redis,既能还原生产引擎语义,又能保证每次测试从干净空库起步(避免假测试详见 /guides/codex-generate-unit-tests-playwright-e2e-avoid-fake-mocks)。 - 用
healthcheck+docker compose up -d --wait替代死板的sleep 5。Docker 官方文档支持通过--wait自动阻塞直到所有声明健康检查的服务进入healthy状态,彻底消灭「容器进程起来了但数据库还在初始化导致连接被拒」的偶发红灯。 - 测试容器必须与日常开发库物理隔离。本站建议为测试专用编排分配独立端口(如
55432、56379)并挂载tmpfs内存盘,既不污染本地开发数据,又能让建表和清库速度成倍加快。 - 守好 Codex 沙箱边界:不要为了跑容器直接放开无限制宿主机权限。若沙箱默认隔离了 Docker Socket,稳妥做法是在宿主机提前执行
docker compose -f compose.test.yml up -d --wait,仅放行测试命令连接本地测试端口,或只针对指定测试脚本逐次审批。 - 多轮运行真实集成测试、排查并发事务与迭代修补接口对 Codex 推理额度消耗明显。国内若缺少外币卡或希望一步到位配置高配额环境,可在本站按需开通 ChatGPT Plus 充值 或高配额 ChatGPT Pro 充值,团队多人研发可了解 ChatGPT Business 团队定制。

图:本站根据 Docker Compose 官方文档 与 OpenAI Codex 文档 整理的示意图
本文根据 Docker 官方文档《Control startup order》《docker compose up》及 OpenAI Codex 官方文档《Codex CLI》《Approvals & security》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 用 Codex 写完后端接口和单元测试全绿,但一联调真实数据库或缓存就冒出 SQL 约束错误、事务隔离异常或 Redis 键过期 Bug 的开发者;
- 希望在本地一键拉起干净的 PostgreSQL 与 Redis 容器,让 Codex 自己跑真实集成测试、看报错修代码并清理环境的后端与全栈工程师;
- 在 Docker 容器启动顺序、端口冲突或 Codex 沙箱访问 Docker Socket 上踩过坑的团队。
一、编写零污染的 compose.test.yml 与一键测试脚本
把测试依赖和日常开发的 docker-compose.yml 分开维护,可以避免 Codex 或测试脚本误清你手动造的本地演示数据。下面是一份可直接落盘到仓库根目录的 compose.test.yml 模板(本站工程建议):
yaml
services:
postgres-test:
image: postgres:16-alpine
environment:
POSTGRES_USER: app_test
POSTGRES_PASSWORD: app_test_password
POSTGRES_DB: app_test
ports:
- "127.0.0.1:55432:5432"
tmpfs:
- /var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app_test -d app_test"]
interval: 2s
timeout: 3s
retries: 15
redis-test:
image: redis:7-alpine
ports:
- "127.0.0.1:56379:6379"
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 2s
timeout: 3s
retries: 15
接着在 package.json(或 Makefile)封装一条统一入口命令,把「起容器并等待就绪 → 跑迁移 → 执行集成测试 → 清理容器」串成原子流程:
bash
# scripts/test-integration.sh
set -euo pipefail
trap 'docker compose -f compose.test.yml down -v' EXIT
docker compose -f compose.test.yml up -d --wait
export DATABASE_URL="postgresql://app_test:[email protected]:55432/app_test"
export REDIS_URL="redis://127.0.0.1:56379/0"
npm run db:migrate:deploy
npm run test:integration
注意端口映射显式绑定在 127.0.0.1,防止测试库端口暴露到局域网。同时把这套测试规范写入仓库 AGENTS.md(护栏模板见 /guides/codex-agents-md-guardrails-stop-deleting-tests):
markdown
# 集成测试约定(AGENTS.md)
- 所有涉及 SQL 事务、唯一索引、外键级联或 Redis 缓存失效的改动,必须通过 `test:integration` 验证。
- 禁止用内存数组或手写 Mock 替换集成测试里的 Postgres / Redis 连接。
- 测试用例之间必须保证数据隔离(独立测试前缀或按用例清理表),禁止依赖用例执行顺序。
二、让 Codex 驱动「跑测 → 诊断 → 最小修补 → 复验」闭环
如果本地已经通过宿主机拉起测试容器(或在审批确认下允许运行封装脚本),可以直接把以下提示词发给 Codex,让它围绕真实数据库报错自闭环修复:
text
本地 Postgres(127.0.0.1:55432) 与 Redis(127.0.0.1:56379) 测试容器已通过 compose.test.yml 就绪。
请针对订单防重复提交与库存扣减模块完成集成测试闭环:
1. 补充覆盖「并发重复提交同一幂等键」「库存不足触发事务回滚」「订单取消后清理 Redis 缓存键」三条真实集成测试;
2. 禁止 Mock 数据库和 Redis 客户端,测试必须真实写入并校验落库与缓存状态;
3. 运行集成测试套件;若测试失败,先区分是业务代码 Bug 还是测试夹具隔离问题,做最小范围修复后重跑直至全绿;
4. 最后汇报新增用例清单、发现并修复的真实缺陷以及最终测试输出摘要。
订阅与账号准备提示:编写多场景真实集成测试、反复排查事务死锁与缓存一致性通常会在短时间内触发密集的多轮工具调用(额度统计与节省技巧见 /guides/codex-save-usage-quota-model-reasoning-context-tips)。重度后端开发推荐按需升级 ChatGPT Pro 5x iOS 可覆盖档 或 ChatGPT Pro 5x 信用卡不可覆盖档;新账号注册若卡在手机验证步骤,可查看 Codex 注册手机验证服务。
三、常见容器与集成测试故障排查决策
把真实容器引入 Codex 闭环后,高频卡点集中在启动时序、端口冲突和并行数据串台。对照下面决策图可在一分钟内定位处置方向:

图:本站根据 Docker 官方文档 与工程排错经验整理的示意图
如果你本身就在无桌面 Linux 服务器或 Docker DevContainer 里运行 Codex CLI,需留意容器嵌套(Docker-in-Docker 与宿主机共享网络)的配置差异,可一并参考 /guides/codex-cli-headless-linux-docker-devcontainer-device-auth 完成认证与挂载设置。
常见问题
问:为什么用 tmpfs 挂载 Postgres 数据目录,不会丢数据吗?
答:compose.test.yml 专门服务于自动化集成测试,测试数据本来就要求「每次随用随建、测完即毁」。把 Postgres 数据目录放到 tmpfs 内存盘里能跳过磁盘刷写开销,让数百条建表与事务用例的耗时明显缩短;日常需要保留数据的本地开发环境仍使用单独的常规 Compose 卷即可。
问:集成测试每次全量跑要好几分钟,怎么避免 Codex 修一个小 Bug 反复空等?
答:先让宿主机常驻起着测试容器,提示词里要求 Codex 在调试阶段只针对单个测试文件执行局部命令(如 npx vitest run tests/integration/order.spec.ts),等该文件全绿且改动收尾后,再统一跑一次全量集成测试与清理脚本,既省时间又省上下文。
问:后端高频跑 Codex 写接口和真实集成测试很费额度,个人或团队怎么开通高配额订阅、能否开增值税发票?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Plus 充值、ChatGPT Plus 自助卡密 或更高配额的 ChatGPT Pro 充值,团队多人统一采购可了解 ChatGPT Business 团队定制。支持支付宝、微信支付和 AlipayHK,自助卡密无需交出账号密码,并支持开具增值税发票;实时价格与规格以页面展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围规则。
相关教程
- 用 Codex 自动补全缺失的单元测试与 Playwright E2E 用例:避免写出假测试
- 在无桌面 Linux 服务器与 Docker DevContainer 里部署 Codex CLI 配置指南
- Codex 写代码时爱删测试或乱改无关文件怎么办:5 条 AGENTS.md 硬约束护栏
- Codex 额度消耗太快怎么省:模型档位切换、推理强度降级与控上下文 6 招
参考资料
- Docker 官方文档:Control startup order in Compose — https://docs.docker.com/compose/how-tos/startup-order/
- Docker 官方文档:docker compose up — https://docs.docker.com/reference/cli/docker/compose/up/
- OpenAI Codex 官方文档:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
- OpenAI Codex 官方文档:Approvals & security — https://learn.chatgpt.com/docs/agent-approvals-security
0 条评论
还没有评论,来抢沙发~