部署至Linux服务器后Selenium无法登录站点 提示chromedriver需在PATH中

• 代码硬编码了Windows本地的chromedriver路径C:/chromedriver，Linux系统无对应路径，进程无法定位驱动文件
• Linux服务器未安装与Chrome版本匹配的chromedriver，也未将驱动可执行文件加入系统PATH环境变量
• 常规Linux服务器为无图形界面的纯命令行环境，原代码未配置Chrome无头运行参数，即使路径匹配也无法正常拉起浏览器进程

1. 服务器环境准备

   • 安装与chromedriver主版本号完全匹配的Chrome浏览器，版本不一致会直接触发驱动兼容报错
   • 下载对应版本的Linux版chromedriver，将可执行文件存放至系统可检索路径（如/usr/bin/chromedriver），执行chmod +x /usr/bin/chromedriver为文件赋予可执行权限，确保系统能在PATH范围内定位到驱动

   驱动与浏览器的版本匹配规则可参考chromedriver官方文档

   • 注意禁止直接上传Windows系统下的chromedriver文件到Linux服务器，两类系统的可执行文件格式不通用

2. 代码适配改造
   移除硬编码的Windows路径，补充Linux无界面环境必需的Chrome启动参数，改造后的参考代码：

   from selenium.webdriver.chrome.options import ChromeOptions
   
   def loginToShipstation(request):
       username = "xxx"
       password = "xxx"
       url = "https://ss.shipstation.com/"
       # 适配无GUI服务器的Chrome运行参数
       chrome_options = ChromeOptions()
       chrome_options.add_argument("--headless=new")
       chrome_options.add_argument("--no-sandbox")
       chrome_options.add_argument("--disable-dev-shm-usage")
       # 驱动已配置到系统PATH后无需手动指定路径；若未配置PATH，可替换为Linux下实际驱动路径如"/usr/bin/chromedriver"
       driver = webdriver.Chrome(options=chrome_options)
       driver.get(url)
       driver.find_element_by_name("username").send_keys(username)
       driver.find_element_by_id("password").send_keys(password)
       time.sleep(1)
       driver.find_element_by_id("btn-login").click()
       # 操作完成后关闭驱动，释放服务器资源
       driver.quit()
       return HttpResponse()
   

3. 常见踩坑排查

   • 确保执行Python代码的系统用户，对chromedriver文件、Chrome安装目录拥有可执行权限，避免权限不足触发访问拒绝报错
   • 旧版Selenium的find_element_by_*系列方法已逐步废弃，高版本Selenium环境下可替换为标准元素定位写法，减少版本兼容问题
   • 服务器内存不足时，Chrome会直接崩溃，可通过调整--disable-dev-shm-usage参数、限制Chrome单进程内存占用解决

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