reCAPTCHA v2 绕过与验证码求解指南
在自动化测试中,绕过 reCAPTCHA v2 分两步:先获取有效的响应令牌,再将令牌交给表单。求解服务负责完成验证挑战并返回令牌,测试再按组件原有的方式传递令牌。应用后端仍需通过 Google 验证令牌,才能接受请求。本文介绍两种组件的区别、参数的查找方法,以及如何在 Python 和 JavaScript 中使用 CapMonster Cloud。
要点
- 测试需要获取有效的响应令牌,并将它交给表单。后端仍会通过 Google 验证令牌。
- 复选框版由用户勾选复选框后触发验证。隐形版可由按钮或代码触发,收到令牌后,回调函数会继续提交流程。
- Google 的标准 v2 令牌有效期为两分钟,只能验证一次。CapMonster Cloud 返回的令牌自求解完成起有效 60 秒,收到后应立即使用。
- RecaptchaV2Task 只需任务类型、页面 URL 和网站密钥。代理、User-Agent 和 Cookie 均为可选项。CapMonster Cloud 对部分集成另有要求。
- 令牌有效,应用也可能拒绝表单。请分别记录求解服务的结果、Google 的验证结果和表单提交结果。
术语
- 网站密钥(websiteKey)。用于标识 reCAPTCHA 集成的公开密钥,决定页面渲染哪个组件。CapMonster Cloud 将这个字段命名为 websiteKey。
- g-recaptcha-response。用于传递 reCAPTCHA 响应令牌的表单字段。组件将令牌存入同名的隐藏 textarea,后端再通过 Google 验证令牌。
- data-s。部分自定义 reCAPTCHA v2 集成会在组件的 HTML 中附加这个一次性值。它与公开的网站密钥和响应令牌是不同的值。
- isInvisible。CapMonster Cloud API 的可选布尔字段。设为 true 表示该任务对应隐形版 v2 组件。
- 任务。提交给 CapMonster Cloud 异步处理的请求。服务为每项已受理的任务分配 ID,用于查询状态或获取结果。
- 令牌有效期。可验证响应令牌的时间范围。即使还在有效期内,一次性令牌也不能重复验证。
复选框版与隐形版 reCAPTCHA v2
两种 reCAPTCHA v2 组件 的主要区别在于触发方式。复选框版要求用户点击“I'm not a robot”。Google 可能直接放行,也可能要求用户完成一道验证挑战。验证通过后,组件会将响应令牌写入隐藏字段,表单提交时会一并发送该字段。
隐形版不显示复选框。用户点击页面现有的按钮(例如 Submit),或应用通过 JavaScript 调用时,都会触发验证。Google 仍可能显示验证挑战。
可以通过组件配置区分这两种版本。隐形模式在 HTML 中使用 data-size="invisible",或者在 JavaScript 中设置 size: "invisible"。该模式还依赖回调函数。验证通过后,Google 会调用 data-callback 指定的函数,或调用传给 grecaptcha.render() 的 callback,并把令牌作为参数传入。随后如何处理由应用代码决定。常见做法是由回调继续提交表单。复选框版也支持回调,但标准表单无需回调即可提交。
两种版本使用相同的服务端验证流程。后端先将令牌发送给 Google 验证,再决定是否接受受保护的请求。如果要自行添加组件,可参考在网站上集成 reCAPTCHA v2 的方法。Enterprise 使用单独的密钥配置,详情见 reCAPTCHA Enterprise 指南。
reCAPTCHA v2 绕过的工作原理
求解服务代替用户完成验证挑战。从组件到服务器,其余流程保持一致。
- 组件。reCAPTCHA 组件在浏览器中发起验证,Google 可能要求用户完成一道挑战。
- 响应令牌。验证通过后,组件返回令牌,页面将其随表单一起发送。CapMonster Cloud 的 reCAPTCHA v2 求解服务完成挑战后,会在任务结果中返回令牌。
- 服务端验证。应用后端将令牌和密钥发送给 Google,再结合 Google 的响应和应用的表单规则,决定是否接受本次提交。
令牌有效期
根据 Google 的服务端验证规则,标准 v2 响应令牌两分钟后过期,且只能验证一次。CapMonster Cloud 文档注明,服务返回的令牌自挑战求解完成起有效 60 秒。收到后应立即使用。
QA 测试需要记录哪些结果
分别记录 reCAPTCHA v2 求解结果、Google 的验证结果和表单处理结果。这样可以定位请求在哪一步失败。另请参阅 2026 年常用的 reCAPTCHA v2 求解方法。
如何查找参数
需要查找公开的网站密钥、组件模式,以及集成使用的 data-s 值(如果有)。这些信息可以在 DevTools 中手动查看。
手动检查
打开包含验证组件的页面,右键点击验证码,选择 Inspect。
在 Elements 标签页中找到组件容器,通常是带有 g-recaptcha 类名的 div。data-sitekey 属性保存公开的网站密钥,对应 websiteKey。如果元素带有 data-size="invisible",说明页面使用隐形版。部分自定义集成还包含 data-s 属性。若存在该属性,将它的值作为 recaptchaDataSValue 传入;该值只能用一次,每次创建任务时都应重新获取。如果应用通过 JavaScript 渲染组件,则查看传给 grecaptcha.render() 的 sitekey 和 size 选项。
打开 Network 标签页,重新加载页面,找到发往 Google reCAPTCHA anchor 端点的请求。参数 k 是网站密钥。如果已确定页面使用 v2,同一请求中的 size=invisible 就能确认是否为隐形模式。页面 HTML 中看不到密钥时,可以用这种方式检查。reCAPTCHA v3 也能加载隐形组件,因此仅凭这个参数无法区分版本。
自动检查
下面的 Playwright 示例针对特定的组件结构:Google 的 anchor iframe,以及组件容器上的 data 属性。脚本会读取网站密钥和组件模式。如果集成包含可选的 data-s,也会输出该值。如果页面采用不同的渲染方式,需要相应调整选择器。
import { chromium } from "playwright";
(async () => {
const browser = await chromium.launch({ headless: false });
const page = await browser.newPage();
await page.goto("https://example.com");
await page.waitForSelector('iframe[src^="https://www.google.com/recaptcha/api2/anchor?"]');
const captchaData = await page.evaluate(() => {
const iframeEl = document.querySelector('iframe[src^="https://www.google.com/recaptcha/api2/anchor?"]');
const captchaUrl = iframeEl?.getAttribute("src");
if (captchaUrl) {
const urlParams = new URLSearchParams(captchaUrl.split("?")[1]);
const sitekey = urlParams.get("k");
const size = urlParams.get("size");
const isInvisible = size === "invisible";
const sitekeyEl = document.querySelector("[data-sitekey]");
const datasEl = document.querySelector("[data-s]");
const datas = datasEl?.getAttribute("data-s");
return {
sitekey: sitekey || sitekeyEl?.getAttribute("data-sitekey"),
datas,
isInvisible,
};
}
return null;
});
console.log(captchaData);
await browser.close();
})();
通过 CapMonster Cloud API 求解 reCAPTCHA v2
CapMonster Cloud 使用 RecaptchaV2Task 任务类型处理标准 reCAPTCHA v2。先调用 createTask 创建任务,再通过 getTaskResult 查询结果。服务会异步处理任务,表单请求仍由应用自身的验证流程和业务逻辑决定如何处理。下表参数来自 RecaptchaV2Task 文档。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| type | 必填 | 任务类型,值为 RecaptchaV2Task。 |
| websiteURL | 必填 | 包含 reCAPTCHA v2 的页面 URL。 |
| websiteKey | 必填 | reCAPTCHA v2 组件的公开网站密钥。 |
| recaptchaDataSValue | 可选 | 字符串。部分自定义 reCAPTCHA v2 集成使用的一次性 data-s 值。每项任务都要重新获取。 |
| userAgent | 可选 | 字符串。用于模拟浏览器的 User-Agent。请使用现代浏览器的 User-Agent。CapMonster Cloud 会发布当前受支持的值,详见下方配置说明。 |
| cookies | 可选 | 字符串。与目标页面或 Google 交互时使用的附加 Cookie。格式为 name1=value1; name2=value2。 |
| isInvisible | 可选 | 布尔值。隐形版 reCAPTCHA v2 使用 true。 |
| proxyType | 可选 | 字符串。代理类型可为 http、https(仅在 http 不可用时)、socks4 或 socks5。 |
| proxyAddress | 可选 | 字符串。代理的 IPv4 或 IPv6 地址。不允许使用透明代理或本地机器上的代理。 |
| proxyPort | 可选 | 整数。代理端口。 |
| proxyLogin | 可选 | 字符串。代理服务器的登录名。 |
| proxyPassword | 可选 | 字符串。代理服务器的密码。 |
CapMonster Cloud 接受任务后会返回任务标识 taskId。求解成功时,reCAPTCHA 响应令牌位于 solution.gRecaptchaResponse。对于部分网站,solution 还会包含 userAgent。此时应使用返回的 User-Agent 提交表单,即使它与浏览器或脚本当前使用的值不同。
配置说明。CapMonster Cloud 默认使用内置代理。只有使用自有代理时才需填代理字段。如果代理通过 IP 进行授权,请将 CapMonster Cloud 的地址加入允许列表。撰写本文时,文档列出的地址为 65.21.190.34。受支持的浏览器 User-Agent 可能变化,运行测试前请查看当前支持的 User-Agent。
在 Python 中处理 reCAPTCHA v2
如果测试需要实际令牌,而不是验证器预设的结果,可以直接调用 CapMonster Cloud API。以下 Python 示例无需自动化浏览器。脚本先调用 createTask,随后轮询 getTaskResult,直到任务完成。运行示例需要 requests 库,以及表单所在页面的 URL 和网站密钥。
import time
import requests
API_KEY = "YOUR_API_KEY"
API = "https://api.capmonster.cloud"
def solve_recaptcha_v2(website_url, website_key, timeout=120):
task = requests.post(f"{API}/createTask", json={
"clientKey": API_KEY,
"task": {
"type": "RecaptchaV2Task",
"websiteURL": website_url,
"websiteKey": website_key,
},
}, timeout=30).json()
if task["errorId"]:
raise RuntimeError(task.get("errorCode"))
deadline = time.monotonic() + timeout
while time.monotonic() < deadline:
time.sleep(3)
result = requests.post(f"{API}/getTaskResult", json={
"clientKey": API_KEY,
"taskId": task["taskId"],
}, timeout=30).json()
if result["errorId"]:
raise RuntimeError(result.get("errorCode"))
if result["status"] == "ready":
return result["solution"]
raise TimeoutError("No result from CapMonster Cloud before the deadline")
solution = solve_recaptcha_v2("https://staging.example.com/signup", "YOUR_SITE_KEY")
token = solution["gRecaptchaResponse"]
函数返回整个 solution 对象,其中包含令牌。对于部分网站,solution 还会返回 userAgent,提交表单时应使用这个值。轮询间隔 3 秒、轮询时间约两分钟,可按测试套件的需要调整。任一方法返回非零 errorId 时,脚本都会停止并报告 API 错误码,便于区分 CapMonster Cloud 故障和表单错误。
收到令牌后应立即使用。按 CapMonster Cloud 的说明,令牌自求解完成起有效 60 秒,且 Google 只会验证每个令牌一次。将令牌放入 g-recaptcha-response 字段发送给表单端点,再检查应用的响应。仅拿到令牌还不能确认表单处理成功。
如何通过浏览器把令牌注入页面,可参阅 Python 与 Selenium 分步指南。
JavaScript 示例
在 Playwright 测试中,可以通过 CapMonster Cloud SDK 获取令牌,再交给页面。测试从组件中读取网站密钥,求解任务,然后把令牌写入 g-recaptcha-response。使用隐形版时,测试还会调用 data-callback 指定的函数。这一步会继续提交表单,单独填写该字段不会触发提交。
import { test, expect } from "@playwright/test";
import {
CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2Request,
} from "@zennolab_com/capmonstercloud-client";
const client = CapMonsterCloudClientFactory.Create(
new ClientOptions({ clientKey: process.env.CAPMONSTER_API_KEY })
);
test("signup with invisible reCAPTCHA v2", async ({ page }) => {
test.setTimeout(120_000);
await page.goto("/signup");
await page.getByLabel("Email").fill("qa-run@example.com");
const widget = page.locator("[data-sitekey]");
const result = await client.Solve(new RecaptchaV2Request({
websiteURL: page.url(),
websiteKey: await widget.getAttribute("data-sitekey"),
isInvisible: true,
}));
if (!result.solution) throw new Error(`CapMonster Cloud error: ${result.error}`);
const token = result.solution.gRecaptchaResponse;
await page.evaluate((token) => {
document.querySelector("#g-recaptcha-response").value = token;
const name = document.querySelector("[data-sitekey]").dataset.callback;
window[name](token);
}, token);
await expect(page.getByText("Check your inbox")).toBeVisible();
});
本例假设组件在 HTML 中通过 data-sitekey 和 data-callback 声明。Google 要求 data-callback 指定全局函数的名称,因此测试可以通过 window 调用该函数。如果应用使用 grecaptcha.render() 渲染组件,则调用应用代码传入的回调。对于复选框版,去掉 isInvisible,按应用的常规流程提交表单。请根据实际表单调整路由、字段标签和确认文案。使用相对路径 /signup 的前提是已在 Playwright 配置中设置 baseURL。
求解后应尽快提交表单,因为 CapMonster Cloud 的令牌只在 60 秒内有效。最后一条断言检查用户看到的结果,还应在后端确认注册记录已经创建。
使用 Selenium WebDriver 实现同样的流程,可参阅 JavaScript 与 Selenium 指南。
注入令牌的三种方式
在 reCAPTCHA v2 绕过流程中,取得令牌后还需要把它交给应用。有三种方式可选,具体取决于表单的实现,以及测试要覆盖哪个环节。
将令牌写入 g-recaptcha-response
组件将响应令牌保存在 ID 为 g-recaptcha-response 的隐藏 textarea 中。标准表单会将该字段和其他数据一并发送。测试可以通过页面脚本设置 textarea 的值,然后照常提交表单。复选框版在表单正常提交且不依赖回调时适用这种方式。
await page.evaluate((token) => {
document.querySelector("#g-recaptcha-response").value = token;
}, token);
调用 data-callback 指定的函数
隐形版需要等待组件回调后才会继续提交,仅填写隐藏字段还不够。读取 data-callback 属性指定的函数名,并将令牌作为参数调用该函数。Google 要求这个属性指向全局函数,因此测试可以通过 window 访问它。如果应用使用 grecaptcha.render() 渲染组件,则调用应用代码传入的回调。如果表单也会读取 textarea,请先设置该字段。
await page.evaluate((token) => {
const name = document.querySelector("[data-sitekey]").dataset.callback;
window[name](token);
}, token);
通过 HTTP 请求发送 g-recaptcha-response
无需打开浏览器,也可以直接将表单数据发送到应用端点,并在 g-recaptcha-response 字段中带上令牌。这种方式测试后端最快,但请求必须与页面实际发送的请求一致,包括相同的会话 Cookie、表单需要的 CSRF 令牌,以及 CapMonster Cloud 返回 userAgent 时对应的 User-Agent 请求头。后端仍会通过 Google 验证令牌,因此这种方式覆盖服务端验证,但不涉及组件或页面自己的 JavaScript。
令牌被拒绝的原因
表单提交失败时,先确认是哪一步出了问题。Google 可能拒绝了令牌,应用也可能因自身的校验或授权规则拒绝表单。通常查该请求的服务器日志更快,因为浏览器中的同一条提示可能对应多种错误。
令牌已过期或已使用。Google 的标准 v2 令牌有效期为两分钟,只能验证一次。CapMonster Cloud 的 60 秒有效期自任务求解完成起计。Google 对令牌过期和重复使用都返回 timeout-or-duplicate,单看错误码无法区分。可以检查从求解完成到提交经过多久,以及有多少个请求携带同一个令牌。自动重试、双击和并发提交都可能导致同一令牌被发送两次。
User-Agent 过时。这个问题出现在客户端,发生在发放令牌之前。如果传给 CapMonster Cloud 的 userAgent 不是受支持的浏览器标识,Google 可能提示“update your browser”,验证流程也无法完成。CapMonster Cloud 会在 User-Agent 参考中发布当前值。
代理、User-Agent 或 Cookie 不一致。Google 的 SiteVerify 请求接收密钥、响应令牌和可选的 remoteip。其文档列出的请求参数不包含 User-Agent 或 Cookie。CapMonster Cloud 对某些集成另有要求。如果通过自有代理求解,请通过同一代理提交令牌。如果 solution 包含 userAgent,请使用该值提交表单,即使它与浏览器或脚本通常使用的值不同。对于 Cookie,文档建议传入自动化流程在目标页面使用的值。
websiteKey 不正确。任务中的 websiteKey 必须与测试页面中组件的 data-sitekey 一致。为其他网站密钥签发的令牌无法用当前后端的密钥通过验证。测试环境和生产环境的密钥不同时,测试可能从配置中读错密钥。如果集成会检查响应中的 hostname 字段,也要确认它接受测试环境的主机名。
其他常见原因可参阅 reCAPTCHA 验证错误及修复方法。
哪些做法无效
后端会检查令牌,因此跳过获取令牌的步骤行不通。用 CSS 隐藏组件、从页面移除组件或禁用 JavaScript,都无法为表单提供有效的 g-recaptcha-response,服务端验证会拒绝请求。已经使用过的令牌也不能重复提交,因为 Google 只验证一次。如果另一页面或另一环境使用的是不同的网站密钥,从那里复制的令牌也无法通过验证。
手动检查表单时,可以使用 CapMonster Cloud 的 Chrome 或 Firefox 扩展程序。扩展程序在当前浏览器会话中运行,适合在浏览器里手动操作表单。自动化测试服务端行为时,仍需检查应用响应,以及提交后是否产生预期的变更。
常见问题
CapMonster Cloud
CapMonster Cloud 是一项自动求解 CAPTCHA 的云服务。对于 reCAPTCHA v2,它通过 RecaptchaV2Task 支持复选框版和隐形版,并返回可随表单提交的令牌。可以通过 API 或官方 SDK 接入。在 QA 流程中,令牌只是测试输入之一,还需要检查服务端验证、表单处理以及应用是否产生预期结果。
NB: 请注意,本产品仅用于对您自身的网站以及您依法拥有访问权限的资源进行自动化测试






