Jenkins执行Selenium测试时Docker报invalid mode: /var/www/html错本地运行正常

报错根因 #

该报错是Docker解析-v卷挂载参数时格式异常导致：Docker会按宿主机路径:容器路径:权限模式的规则分割-v参数，当宿主机路径中存在额外冒号、特殊字符时，Docker会误把冒号后的内容识别为权限模式，最终判定/var/www/html为非法模式值。

本地运行正常、Jenkins运行异常的核心差异是命令执行环境不同，常见触发场景如下：

• 本地为Windows/macOS环境，Docker Desktop自带路径兼容逻辑，可自动识别盘符冒号；Jenkins运行在Linux/WSL环境下无对应兼容，路径格式不匹配
• Jenkins任务的工作目录包含空格、中文、冒号等特殊字符，导致-v参数分割逻辑出错
• Jenkins本身是容器化部署，你传入的是Jenkins容器内部路径，而非物理机真实路径，路径解析失效
• 命令中硬编码了Windows格式的盘符路径（如C:\jenkins\workspace\project:/var/www/html），Linux环境无法识别，盘符冒号打乱了参数分割规则

从你提供的命令截图也可以验证，你使用了带盘符的Windows格式路径，是该问题的典型触发原因。

修复方案 #

按优先级逐一排查验证即可：

1. 统一路径格式
   跨操作系统场景下，把Windows盘符路径转换为Unix格式路径：
   • WSL环境下转换为/mnt/c/jenkins/workspace/project格式
   • 优先使用相对路径挂载，避免盘符冒号冲突，示例：./project:/var/www/html
2. 引号包裹挂载参数
   执行Docker命令时用单引号包裹完整的-v参数，避免特殊字符被截断：

   docker run -v '/你的/宿主机/路径:/var/www/html' 你的镜像名
   

3. 校验Jenkins路径变量
   在Jenkins任务中先新增一步路径打印命令，确认传入Docker的路径是否符合预期：

   echo $PWD
   echo ${你用来挂载的自定义路径变量}
   

4. 容器化Jenkins特殊处理
   如果Jenkins本身是Docker容器部署，需要对齐Jenkins容器的工作目录挂载路径和你传给Docker命令的物理机路径，保证两层路径映射一致。

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