Codeception 安装后 codecept 命令不识别需全局安装并配置 PATH；Acceptance 测试失败主因是 WebDriver 环境配置不当，应直连 Chrome、用稳定选择器、显式等待，并适配 CI 的无头模式与网络设置。
Codeception 安装后 codecept 命令不识别
常见现象是执行 codecept bootstrap 报错 “command not found”，本质是二进制没进 PATH 或未全局安装。
推荐用 Composer 全局安装：composer global require codeception/codeception，然后确保 ~/.composer/vendor/bin（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）已加入系统 PATH。
- 别用
php composer.phar require codeception/codeception --dev装在项目里再硬调vendor/bin/codecept—— 端到端测试通常跨项目复用，路径一变就断 - 验证是否生效：终端直接运行
codecept -V，应输出版本号 - 如果用 Docker，记得在容器内也装好
codeceptCLI，不能只依赖宿主机
写 Acceptance 测试时 WebDriver 启动失败或超时
不是代码写错了，大概率是浏览器驱动、Selenium 服务或网络配置没对齐。
Codeception 的 Acceptance 测试默认走 WebDriver 模块，它需要真实浏览器 + 对应驱动（如 chromedriver）+ 可选的 Selenium Server。跳过 Selenium 直连 Chrome 更稳：
立即学习“PHP免费学习笔记（深入）”；
- 改
acceptance.suite.yml：把url设为被测站点地址，browser设为chrome，删掉selenium相关配置 - 确保
chromedriver在 PATH 里，且版本与本地 Chrome 匹配（查 Chrome 版本：google-chrome --version；对应驱动下载页：https://chromedriver.chromium.org/） - 加
wait: 5和restart: true到 WebDriver 配置里，避免会话残留导致后续测试卡住
see() 和 seeElement() 总是报“element not found”
不是页面没加载完，就是定位器写得太脆 —— 比如依赖 class 名、顺序索引、或内联样式。
端到端测试最怕 DOM 微调就全挂，得用语义化、稳定的选择器：
- 优先用
[data-test-id="xxx"]这类专用属性，开发时加，测试时读，互不干扰 - 避免
//div[2]/button这种位置路径；改用//button[contains(., "提交")]或 CSS：button[type="submit"] - 加显式等待：
$I->waitForElement('.submit-btn', 10)，再$I->click('.submit-btn')，别信默认隐式等待 - 调试技巧：测试失败时加
$I->savePageSource()，生成 HTML 快照，看实际渲染结构
CI 环境跑 Acceptance 测试失败，但本地能过
核心差异就三点：无图形界面、时区/语言环境不同、网络策略更严。
GitHub Actions / GitLab CI 默认没桌面环境，Chrome 必须加 --headless=new 和 --no-sandbox 启动参数：
- 在
acceptance.suite.yml的WebDriver下加：capabilities: {"goog:chromeOptions": {"args": ["--headless=new", "--no-sandbox", "--disable-dev-shm-usage"]}} - CI 中 PHP 和 Node 版本要跟本地对齐，尤其 Codeception 5.x 要求 PHP ≥ 8.0
- 被测站点如果是
http://localhost:8000，CI 容器里可能访问不到 —— 改用http://host.docker.internal:8000（Docker Desktop）或启动服务时绑定0.0.0.0
端到端测试真正难的从来不是写几个 amOnPage()，而是让同一套逻辑在开发机、CI、预发环境都稳定触发真实交互。DOM 结构、网络延迟、浏览器行为差异，每个点都得单独抠。
