Codex 搭配 Docker Compose 启动本地 Postgres / Redis 并跑通集成测试闭环

单测全靠 Mock 容易掩盖 SQL 语法、事务死锁和 Redis 过期问题。本文拆解如何用独立 compose.test.yml、healthcheck 与 --wait 搭配 Codex 跑通真实 Postgres/Redis 集成测试闭环。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Plus 账号

结论先说

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

Docker Compose 集成测试五步闭环

图:本站根据 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,自助卡密无需交出账号密码,并支持开具增值税发票;实时价格与规格以页面展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围规则。

相关教程

参考资料

  • 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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~