Selenium代理用户名密码不生效怎么办？分清代理入口、407挑战与认证处理

Selenium代理用户名密码不生效，最常见的原因不是账号一定错误，而是把“代理地址”和“认证凭据”塞进了同一个配置。Chrome 的手动代理设置只负责选择代理服务器；Chromium 官方文档明确说明，Chrome 不会使用嵌在手动代理设置里的明文用户名和密码。于是 http://user:pass@host:port 看似完整，浏览器实际可能只拿到了入口，首个请求仍停在 407 Proxy Authentication Required。

正确做法是先确认代理入口确实生效，再让浏览器在收到认证挑战时提供凭据。本文面向自有系统、公开许可页面或已获授权的自动化测试，不讨论绕过验证码、访问控制或平台规则。

先判断失败发生在哪一层

不要看到页面打不开就连续换 IP。先保存一次脱敏诊断结果，并按下面四层定位：

还要分清两条不同链路：Selenium Manager 下载浏览器或驱动时使用的代理，不等于浏览器会话访问网页时的代理；给 Python、Java 或 CI 环境设置下载代理，也不会自动替代 WebDriver 会话里的代理配置。

代理地址不要拼用户名密码

以 Chrome 为例，启动参数只放协议、主机和端口：

import os
from selenium import webdriver

proxy_host = os.environ["PROXY_HOST"]
proxy_port = os.environ["PROXY_PORT"]

options = webdriver.ChromeOptions()
options.add_argument(f"--proxy-server=http://{proxy_host}:{proxy_port}")
driver = webdriver.Chrome(options=options)

这里刻意不读取、打印或拼接用户名密码。完整代理 URL 一旦进入命令行参数、异常栈、进程列表或截图，就可能泄露凭据。资源信息应由密钥管理系统或受保护的环境变量提供，日志只记录资源别名、认证结果和脱敏错误。

如果服务商支持来源公网 IP 白名单，而且执行机出口固定，白名单通常是更简单的浏览器接入方式：浏览器只需要代理入口，不必处理交互式认证挑战。启用前要确认服务商看到的是执行机公网出口，而不是局域网地址；CI 出口变化时，旧白名单会立即失效。

用户名密码应在认证挑战阶段处理

必须使用账密认证时，优先评估当前 Selenium、浏览器和语言绑定是否已支持 WebDriver BiDi 的网络认证处理。Selenium 官方网络 API 已提供 authentication handler，W3C WebDriver BiDi 规范也把 401 的 WWW-Authenticate 与 407 的 Proxy-Authenticate 纳入认证挑战，并通过 network.continueWithAuth 提交凭据。

但这项能力仍需按实际版本验证，不能从一段别人的示例推断所有浏览器都支持。上线前固定 Selenium、浏览器和驱动版本，在测试代理上确认三件事：能捕获 407；只提交一次正确凭据；错误凭据不会无限触发认证回调。若语言绑定的高层 API 尚未稳定，不要直接依赖私有方法，先查对应版本的Selenium WebDriver BiDi 网络文档和 API 说明。

另一种办法是使用 Chrome 扩展监听 onAuthRequired。Manifest V3 下，扩展需要 webRequest 与 webRequestAuthProvider 权限；旧教程常用的 webRequestBlocking 对普通 MV3 扩展已不再普遍开放。扩展还要面对 Service Worker 生命周期、权限范围和无头模式兼容性，因此应把它视为需要版本回归的组件，而不是复制一段 Manifest 就结束。认证回调必须限制重试次数，并核对挑战确实来自预期代理，避免把代理凭据提交给非预期目标。

用四组对照测试确认修复

在自有健康检查地址或明确允许的测试端点执行四组小样本：

1. 不配置代理，建立直连基线；
2. 只配置代理入口，确认出现预期 407；
3. 配置正确凭据，确认认证成功且出口符合订单地区；
4. 使用专门的失效测试凭据，确认系统记录一次认证失败后停止。

每组都记录 Selenium 版本、浏览器版本、代理协议、状态码、总耗时和脱敏出口摘要。连接成功不等于业务成功，后续还应区分目标站 403、429、页面结构变化和解析失败。需要批量管理节点时，可参考Selenium代理IP池的会话租约与健康检查；要建立通用质量门禁，可结合代理IP自动验证方法。

Selenium代理用户名密码不生效的排查顺序可以归纳为：先证明浏览器使用了正确代理入口，再确认收到的是 407 而不是目标站 401，最后选择白名单、WebDriver BiDi 认证处理或经过回归验证的 MV3 扩展。不要把凭据拼进启动参数，也不要用无限换 IP 掩盖认证配置错误。需要核对协议、认证方式、地区和并发能力时，可到悟空代理官网查看当前公开说明，并以实际订单与接口文档为准。