菜单
集成测试策略——测试范围界定、测试替身选择、数据准备、外部依赖治理、并发与稳定性。当跨模块协作、依赖数据库 / 消息队列 / 外部 API 时触发。 触发词：集成测试、integration test、contract test、test containers、外部依赖、数据库测试、mock vs real。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | integration-test-strategy |
| type | testing-strategy |
| description | 集成测试策略——测试范围界定、测试替身选择、数据准备、外部依赖治理、并发与稳定性。当跨模块协作、依赖数据库 / 消息队列 / 外部 API 时触发。 触发词：集成测试、integration test、contract test、test containers、外部依赖、数据库测试、mock vs real。 |
| version | 1.0.0 |
| author | specforge |
集成测试的价值来自「真实依赖」，不是「更多断言」。 如果把依赖全 mock，就退化成慢版本的单元测试，失去跨边界正确性验证的意义。
本文讨论的「集成测试」指模块与外部组件交互的测试：
不包含端到端（E2E）测试——那是用户视角的黑盒流程验证。
┌─────────┐
│ E2E │ 5-10%
├─────────┤
│ 集成 │ 20-30%
├─────────┤
│ 单元 │ 60-70%
└─────────┘
| 场景 | 原因 |
|---|---|
| SQL 查询 / 索引 / 事务语义 | 单元 mock 无法发现 SQL 方言差异 |
| 消息队列的分区、顺序、重试语义 | broker 行为需真实环境 |
| 缓存的 TTL、序列化、并发冲突 | 需验证 Redis/Memcached 实际行为 |
| 第三方 API 的错误码、限流、鉴权 | contract test + wiremock 回放 |
| 迁移脚本对真实 schema 的影响 | 直接跑 migration |
| 场景 | 处理方式 |
|---|---|
| 纯业务规则 | 下沉到单元测试 |
| UI 交互、浏览器行为 | 上移到 E2E |
| 跨多个微服务的完整用户旅程 | 上移到 E2E 或契约测试 |
| 类型 | 说明 | 何时使用 |
|---|---|---|
| 真实依赖 | 容器化（Testcontainers）启动真实组件 | 默认选择，尤其是 DB / 消息队列 |
| Fake | 轻量等价实现（如内存数据库） | 真实依赖启动代价过高且行为可等价 |
| Stub | 返回预设响应 | 第三方 API 不可达、无沙箱环境 |
| Mock | 验证交互次数 / 参数 | 仅在需要断言「怎么调用」而非「调用什么」时 |
| Wiremock / MSW | 录制回放 HTTP 依赖 | 外部 API 集成测试 |
默认倾向：优先使用 Testcontainers 起真实的 PostgreSQL/Redis/Kafka，而不是内存替身。替身偏差带来的假阳性比测试慢一点的代价大得多。
真实世界的失败多样，集成测试必须覆盖：
工具：toxiproxy、wiremock fault injection、本地 chaos proxy。
Thread.sleep(1000)。--repeat-each 抽查。integration-test 任务与 CI stage，与单元测试区分。@IntegrationTest / -tags=integration / describe.concurrent）区别执行。pre-merge 门禁包含集成。| 能力 | Java | Python | Go | Node.js |
|---|---|---|---|---|
| 容器化依赖 | Testcontainers-Java | testcontainers-python | testcontainers-go | testcontainers |
| HTTP Mock | Wiremock / MockWebServer | responses / pytest-httpx | httptest / gock | MSW / nock |
| 契约测试 | Pact-JVM / Spring Cloud Contract | pact-python | pact-go | @pact-foundation/pact |
| 数据库迁移验证 | Flyway / Liquibase + Testcontainers | Alembic + testcontainers | golang-migrate + testcontainers | knex / Prisma migrate + testcontainers |
| 消息队列 | EmbeddedKafka / Kafka testcontainer | aiokafka + testcontainer | confluent-kafka-go + testcontainer | kafkajs + testcontainer |
| 反模式 | 问题 | 修正 |
|---|---|---|
| 所有依赖都 mock | 集成测试退化为慢速单元测试 | 关键依赖用真实或 testcontainer 版本 |
| 共享单一数据库不清理 | 测试互相污染，失败难复现 | 事务回滚或 schema 隔离 |
| 依赖网络到 staging 环境 | CI 不稳定，凭证外泄风险 | 本地容器化或契约测试 |
| 没有超时 / 失败路径测试 | 只有 happy path，生产事故频发 | 显式覆盖超时、5xx、限流等 |
用 sleep 等待异步结果 | 不稳定、慢 | 使用条件等待与超时组合 |
| 集成测试混杂在单元测试套件 | 本地跑测试慢，开发者跳过 | 分层、分标签、独立 CI stage |
sleep；异步验证使用条件等待。用 citty + @clack/prompts 构建 Node.js CLI 的端到端工作流，覆盖命令路由、参数 schema、 终端交互、异步任务 UI 与 ESM 发布。触发词：citty、clack、prompts、CLI、命令行、子命令、 交互式、spinner、defineCommand、runMain、ESM 发布。
构建、扩展或调试 CodeMirror 6 浏览器代码编辑器，覆盖状态事务、扩展原语、 装饰、Compartment、语言包、补全诊断、主题、React 集成与 CM5→CM6 迁移。 触发词：CodeMirror 6、CM6、@codemirror/、EditorView、StateField、 Lezer、@uiw/react-codemirror。
使用 @pierre/diffs 与 @pierre/trees 构建代码审查、PR 视图、IDE 文件树、Merge Conflict 解决器。 覆盖 React/Vanilla API、虚拟化、Worker Pool、SSR、Shadow DOM 主题、CodeMirror 集成。 触发词：pierre、diff 渲染、文件树、PR 视图、merge conflict。
GitHub 仓库运营 + npm 包 tag 触发发布的一体化工作流。覆盖 issue/PR 分诊、CI 排障、 安全告警，以及 npm publish（provenance / scoped）+ 自动 GitHub Release（CHANGELOG 段落注入）。 触发词：github、gh、release、publish、tag、npm、provenance、changelog、triage、ci broken、版本发布。
为长跑 AI Coding 任务（Codex /goal、Claude Code、Cursor、Kiro autopilot）构建可审计、 不假完成、抗漂移的提示词。激活后先澄清需求、自动加载 AGENTS.md / 当前 spec / lessons.md， 再产出 5 段式 goal 与长跑健康守则。触发词：goal、写 goal、长任务、长跑、ralph。
使用 Mantine 组件库构建 React UI。涵盖核心组件选型、主题定制、Styles API、 布局模式、表单处理、日期选择器、图表、日程组件、通知系统、模态框管理、 Spotlight 搜索、文件上传、轮播、富文本编辑与 50+ hooks。 触发词：Mantine、UI 组件、主题配置、Styles API、DatePicker、Schedule、 Heatmap、通知、模态框、表单布局、Spotlight、Dropzone、Carousel、hooks。