cv2.imread返回none的常见原因包括相对路径错误、中文路径不兼容、文件损坏、权限不足及扩展名与实际格式不符；推荐用cv2.imdecode(np.fromfile())读取中文路径或直接从内存bytes加载。
验证码识别失败时，cv2.imread 读不出图或返回 None
常见于相对路径写错、截图保存失败、或 Selenium 截图前页面未加载完成。Selenium 的 screenshot() 方法默认保存整个页面，但验证码区域可能被遮挡或动态渲染未就绪。
实操建议：
- 用
element.screenshot('captcha.png')直接截取验证码WebElement，比全页截图更可靠 - 确保元素已存在且可见：在截图前加
WebDriverWait(driver, 5).until(EC.visibility_of(element)) - 检查文件权限和路径：Linux/macOS 下注意当前工作目录，推荐用
os.path.join(os.getcwd(), 'captcha.png')显式拼接 - 用
cv2.imdecode(np.frombuffer(img_bytes, np.uint8), cv2.IMREAD_COLOR)直接从内存 bytes 加载（避免磁盘 I/O 和路径问题）
用 PyTorch 模型做端到端识别时，model.eval() 忘记调用导致预测结果乱跳
训练好的 CNN 或 CRNN 模型在推理阶段必须关闭 dropout 和 batch norm 的训练行为，否则输出不稳定——尤其对小尺寸验证码（如 4 字符、60×30 像素），单次预测偏差可能高达 50%。
实操建议：
- 加载模型后立即执行
model.eval()，并在torch.no_grad()上下文中运行前向传播 - 输入图像需与训练时完全一致：灰度/RGB、归一化方式（如
/255.0还是transforms.Normalize）、尺寸插值方法（cv2.INTER_AREA更适合缩小） - 若模型输出是字符概率分布（如 CTC 解码），务必用
torch.argmax(logits, dim=-1)后再 decode，别直接取 softmax 最大索引——CTC 需专门的解码逻辑
Selenium 点击坐标偏移，driver.execute_script("arguments[0].click()") 也不生效
页面缩放、滚动位置、iframe 嵌套都会导致 location_once_scrolled_into_view 计算出的坐标失准；而 JS click 绕过事件监听器，某些前端校验（如记录鼠标轨迹）会拒绝该点击。
实操建议：
- 先切到对应
iframe：用driver.switch_to.frame(element)，否则定位永远失败 - 用
ActionChains(driver).move_to_element_with_offset(element, x, y).click().perform()比绝对坐标更鲁棒 - 若验证码是点选类型（如“点击所有水果”），需先用模型输出坐标偏移量，再结合
element.location和element.size换算真实页面坐标 - 点击后加短延时 + 判断新元素是否出现（如跳转后的 URL 或 success toast），避免后续操作抢在响应前执行
部署到 Linux 服务器时，WebDriverException: Message: unknown error: Chrome failed to start
无头 Chrome 在 Docker 或 CentOS 环境中常因缺少沙盒、字体、共享内存等依赖启动失败，和验证码识别本身无关，但会卡死整个流程。
实操建议：
- 启动参数必加：
--no-sandbox、--disable-dev-shm-usage、--disable-gpu、--headless=new - 确认 ChromeDriver 版本严格匹配 Chrome 版本（
chromium-browser --version与chromedriver --version输出一致） - 在 Docker 中安装字体包：
apt-get install -y fonts-wqy-zenhei fonts-liberation，否则中文验证码渲染为空白方块 - 模型推理部分尽量剥离 Selenium：把截图传给独立的 FastAPI 接口做识别，主爬虫只负责调度和点击——降低单进程资源压力
element.screenshot() 返回黑图，或者第 4 步的 headless Chrome 根本没起来——这些比调参更值得优先排查。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
