Docker环境下selenium/chromedriver运行Nightwatch测试失败

按故障出现概率从高到低排序，逐项验证即可：

• 1. 首先确认Selenium容器内Chrome是否完整加载前端静态资源 #

  这是该场景下最高发的根因：
  本地测试访问http://localhost:8090时，前端构建配置的资源路径默认匹配localhost，JS/CSS可正常加载；但容器内Selenium的Chrome访问http://frontend:8090时，如果前端配置的资源前缀硬编码为localhost，Chrome会从自身容器的localhost地址拉取静态资源，直接请求失败，最终拿到的只有未经过Vue渲染的原始HTML骨架，自然找不到Vue挂载后生成的#loginBt、表单输入框这类动态DOM元素。
  验证方法：在测试用例开头加截图、打印页面源码的逻辑，执行测试后查看结果：如果截图显示空白页、或只有基础HTML结构没有登录表单，查看源码里script/link标签的src/href属性，如果指向http://localhost:8090/xxx.js这类地址即可确认问题。
  解决方案：修改前端构建配置（vue.config.js/vite.config.js），将publicPath设为相对路径/，不要硬编码localhost域名；如果是开发模式启动，将devServer的host配置为0.0.0.0，允许跨容器域名访问资源。

• 2. 补全Docker环境下Chrome的必填启动参数 #

  Docker环境运行Chrome缺少适配参数会导致渲染进程异常，表面页面返回200实际DOM未完成渲染：
  官方selenium/chrome镜像默认没有配置容器环境适配参数，会因为共享内存不足、沙箱权限问题导致渲染进程崩溃，看起来页面加载成功，实际DOM树根本没有渲染完成。
  解决方案分两步：

  1. 修改nightwatch-selenium.conf.js里的Chrome配置，补全启动参数：

  desiredCapabilities: {
    browserName: 'chrome',
    'goog:chromeOptions': {
      args: [
        '--no-sandbox', // 容器内必须关闭沙箱，否则权限不足无法启动渲染进程
        '--disable-dev-shm-usage', // 不使用默认的/dev/shm共享内存，避免容器默认64M共享内存不足导致渲染崩溃
        '--disable-gpu',
        '--window-size=1920,1080', // 固定视口尺寸，避免响应式布局下元素结构变化导致定位失败
        '--headless=new' // 无界面模式按需配置，有界面版本可去掉
      ]
    }
  }
  

  2. 修改docker-compose.yml中selenium服务的配置，分配足够的共享内存：

  services:
    selenium-chrome:
      image: selenium/standalone-chrome:latest
      shm_size: '2gb' # 和本地物理机运行Chrome的内存配置对齐
  

• 3. 调整元素等待逻辑适配容器环境速度 #

  本地运行时IO、网络速度快，Vue挂载+页面渲染1-2秒即可完成，5000毫秒的等待阈值足够；但Docker环境下跨容器网络转发、前端开发模式的按需编译、Chrome渲染速度都比本地慢，5秒等待不足时，元素还未渲染就会触发NoSuchElementError。
  解决方案：

  • 全局将Nightwatch的默认元素等待超时调整到15000毫秒，不要硬编码5000毫秒的短超时；
  • 摒弃固定时长的sleep等待，每一步操作前优先等待当前步骤需要交互的核心元素可见，再执行后续操作。

• 4. 确认前端服务完全启动后再执行测试 #

  如果前端以开发模式启动，首次访问路由时会实时编译对应组件资源，如果在frontend服务刚启动就立刻执行测试，第一次访问login页面时编译还未完成，会返回临时加载页或空内容，自然找不到目标元素。
  解决方案：在执行测试命令前，先轮询http://frontend:8090/login地址，确认返回200状态码、且页面包含核心静态资源标识后，再启动测试脚本；也可以直接在docker-compose中配置服务依赖的健康检查，等待frontend服务健康状态通过后再启动测试任务。

• 5. 兜底定位方法 #

  如果以上步骤都未解决问题，直接在测试用例访问login页面后加browser.pause(15000)强制等待15秒，之后截取全页截图、打印完整页面源码：

  • 如果源码中确实没有目标元素，顺着浏览器控制台的资源加载报错，排查网络连通性、前端路由配置、反向代理配置问题；
  • 如果源码中存在目标元素，检查选择器是否书写错误、元素是否被包裹在iframe中、是否有全局遮罩层挡住元素导致交互失败。

内容的提问来源于stack exchange，提问作者Alex Popov