Laravel Dusk报错主因是ChromeDriver版本、APP_URL配置、JS渲染时机三者未对齐：需主版本一致、APP_URL带协议端口且无尾斜杠、visit后用waitFor而非assertSee。
跑 php artisan dusk 报错、页面白屏、元素点不了、断言超时——这些问题基本不是测试逻辑写错了，而是 ChromeDriver 版本、APP_URL 配置、JS 渲染时机这三者没对齐。
ChromeDriver 版本与 Chrome 必须主版本一致
报 SessionNotCreatedException 或 unknown error: cannot find Chrome binary，90% 是驱动和浏览器主版本不匹配。Chrome 124 就必须配 chromedriver 124.x，小版本（如 124.0.6367.78）可宽松，主版本号必须严丝合缝。
- 查 Chrome 版本：
google-chrome --version（macOS/Linux）或chrome.exe --version（Windows） - 查 chromedriver 版本：
chromedriver --version；若提示command not found，说明不在$PATH或根本没装 -
php artisan dusk:install默认把驱动放进tests/Browser/Drivers/，但 Dusk 只在系统$PATH中找它，除非你在DuskTestCase里显式指定路径 - Mac M 系列用户务必下载
arm64架构的chromedriver，x86_64会静默失败 - 临时验证：进
tests/Browser/Drivers/目录，执行chmod +x chromedriver
APP_URL 必须带协议、端口，且不能以斜杠结尾
APP_URL 不是摆设，Dusk 完全不读 php artisan serve 的地址，只认 .env 里的这个值。写错一个字符，所有测试都会跳到错误地址，404 或连接拒绝。
- 错误写法：
APP_URL=http://localhost→ 实际跳转http://localhost/login，而你的服务跑在:8000 - 正确写法：
APP_URL=http://127.0.0.1:8000（推荐，避免 DNS 解析延迟）或APP_URL=http://localhost:8000 - Valet 用户必须写完整 HTTPS 域名：
APP_URL=https://yourapp.test，并确保该域名能被 Chrome 正常访问（valet secure后还要手动信任证书） - 改完立刻执行
php artisan config:clear，否则底层 HTTP 客户端可能缓存旧值 - 绝对不要加末尾斜杠：
APP_URL=http://127.0.0.1:8000/→ 错误
visit() 后不能直接 assertSee()，必须显式等待
visit() 只发导航请求，不等 DOMContentLoaded，更不等 Vue/React 挂载、AJAX 返回、CSS 动画结束。此时 DOM 往往还是空壳，assertSee() 必然失败。
- 优先用
->waitForText('登录')或->waitFor('.submit-btn', 10)（单位秒），而不是assertSee() -
assertSee()区分大小写，且只检查可见文本节点（display: none或visibility: hidden的内容会被忽略） - Vue/React 页面建议加一层
->script('return window.appReady || false')等待应用就绪信号，或配合->pause(500) - 调试时加
$browser->dump()->pause()，看实际 DOM 快照，比猜更准
CI 环境必须启用 headless 模式并禁用 sandbox
GitHub Actions / GitLab CI 默认无图形界面，Dusk 尝试启动 GUI Chrome 必然失败。不加 --headless=new 和 --no-sandbox，SessionNotCreatedException 会反复出现。
- 在
tests/DuskTestCase.php的driver()方法中强制配置 ChromeOptions： $options->addArguments(['--headless=new', '--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage']);- CI 中应注释掉
static::startChromeDriver()（在prepare()方法里），改由系统预装 Chrome + 自带 driver 管理 - GitHub Actions 示例中需显式安装 Chrome：
uses: browser-actions/setup-chrome@latest - Linux CI 环境还需预装系统库：
libnss3、libx11-xcb1、libgbm1等，否则 Chrome 启动即崩溃
真正卡住人的从来不是怎么写 ->click()，而是 ChromeDriver 是否真能启动 Chrome、APP_URL 是否让请求落到正确的端口、页面 JS 是否执行完毕——这三个点任何一个偏移，测试就停在黑屏或超时上。
