验证码识别失败常见报错包括invalidimageformat、imagesizetoolarge、requestbodyparseerror、unauthorizedoperation；实操需校验图片格式与大小、正确base64编码、确认api前缀要求及密钥权限。
验证码识别失败的常见报错有哪些
调用第三方 OCR 接口（如百度 OCR、腾讯云 OCR、阿里云 OCR）时，最常遇到的不是“识别不准”，而是请求直接失败。典型错误包括：InvalidImageFormat（图片非 JPG/PNG/BMP）、ImageSizeTooLarge（超过 4MB）、RequestBodyParseError（没把图片 base64 编码或没加前缀 data:image/jpeg;base64,）、UnauthorizedOperation（密钥过期或权限不足）。这些错误往往被当成“OCR 不准”去调参，实际连请求都没发出去。
实操建议：
- 先用
requests.head(url)检查验证码图片 URL 是否可访问，避免爬到空响应或重定向跳转后的 404 - 保存原始图片到本地，用
file -i img.jpg或 Python 的imghdr.what()确认真实 MIME 类型，别信响应头里的Content-Type - base64 编码前必须用
rb模式读取，且去掉换行符：base64.b64encode(img_bytes).decode('utf-8').replace('\n', '') - 百度 OCR 要求 base64 字符串必须带
data:image/xxx;base64,前缀；腾讯云则不要——看文档比抄示例更可靠
为什么不能直接用 pytesseract 本地识别验证码
pytesseract + tesseract-ocr 在简单数字验证码上还能凑合，但只要出现扭曲、粘连、噪点、背景干扰，识别率就断崖下跌。更关键的是：多数网站验证码是动态生成的，字体、角度、干扰线每次都不一样，本地模型根本没法泛化。你花一小时调 image_to_string(img, config='--psm 8')，不如直接对接一个已训练好的商业 OCR。
实操建议：
- 除非验证码是纯白底黑字无干扰的固定格式（比如老系统后台），否则别在本地 OCR 上死磕
- 如果必须本地跑，优先用
cv2.threshold二值化 +cv2.morphologyEx去噪，再送入 tesseract；pytesseract.image_to_boxes比image_to_string更容易定位字符位置 - 注意 tesseract 5.3+ 默认使用 LSTM 模型，对验证码这种小图效果反而不如旧版 Tesseract 4 的 legacy 模式，可显式指定：
config='--oem 0 --psm 8'
如何安全传验证码图片给第三方 OCR（不暴露业务逻辑）
直接把爬虫中构造的完整请求（含 cookies、headers、目标 URL）发给 OCR 接口，等于把你的登录态和反爬绕过策略全交出去。尤其当验证码和登录接口共享 session_id 时，第三方服务若被攻破，你的账号就裸奔了。
实操建议：
- 只传图片本身，绝不传 referer、cookie、user-agent 等任何上下文字段
- 从网页中提取验证码
<img src="...&t=1712345678">后，用独立 session 下载，不复用登录 session - 如果网站用 canvas 渲染验证码（越来越常见），得用 Selenium 截图后裁剪，再传图；此时注意截图区域坐标要稳定，别依赖绝对像素值，改用
element.location_once_scrolled_into_view定位 - 所有 OCR 请求走代理池或固定出口 IP，避免高频请求触发服务商风控（比如腾讯云对同一 IP 每分钟限 5 次通用文字识别）
识别结果怎么校验才不至于填错登录表单
OCR 返回的字符串里混入空格、字母 O 和数字 0、小写 l 和数字 1 是家常便饭。直接拿结果填 <input name="captcha">，十次八次会因格式错误被拒，还可能触发账号锁定。
实操建议：
- 强制清洗：用正则
re.sub(r'[^a-zA-Z0-9]', '', result)去掉所有非字母数字字符 - 做字符映射替换：
result.replace('O', '0').replace('l', '1').replace('I', '1')，但别全局替换，先判断长度是否匹配（比如验证码固定 4 位，清洗后只剩 3 个字符就得重试） - 调用 OCR 接口时开启
detect_direction（百度）或detect_language（腾讯），避免把中文干扰线误识成汉字 - 设置 fallback：单次识别失败或置信度低于 0.7，自动刷新验证码并重试，最多 3 次；第 3 次仍失败就抛出
CaptchaUnsolvableError让人工介入，别硬填
真正麻烦的不是调不通接口，而是你以为识别成功了，其实返回了个 “O0l1” —— 这种错填进去，比不填还糟。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
