Lỗi ERROR_WRONG_GOOGLEKEY: nguyên nhân và cách khắc phục

Gửi đủ tham số nhưng CaptchaAI vẫn trả ERROR_WRONG_GOOGLEKEY? Gần như mọi trường hợp quy về một trong ba lý do: sitekey trích xuất sai, thiếu cờ enterprise=1/invisible=1, hoặc sitekey đã bị xoay sau lần trích xuất trước. Bài này đi thẳng vào từng nguyên nhân, cách xác định và code xử lý — sửa xong trong một lần đọc thay vì thử-sai từng tham số.

Chẩn đoán lỗi

Vì sao bạn gặp lỗi này

Tình huống thường gặp ở các team QA/automation Việt Nam: một agency outsourcing kiểm thử form đăng nhập trên staging.example.com bằng script CI chạy mỗi sáng. Sau một lần deploy, frontend đổi sitekey mới trên Google reCAPTCHA Admin Console — cả pipeline bắt đầu trả ERROR_WRONG_GOOGLEKEY dù code test không đổi gì. Trích xuất lại sitekey trước mỗi lần gửi, thay vì hardcode rồi tái sử dụng mãi, tránh được sự cố này.

Bảng tra cứu nhanh khi vẫn gặp lỗi

Trích xuất và xác thực sitekey

Cách 1: Đọc từ mã nguồn trang

import re
import requests

def extract_sitekey(page_url):
    """Extract reCAPTCHA sitekey from page source."""
    resp = requests.get(page_url, timeout=15)
    html = resp.text

    # Pattern 1: data-sitekey attribute
    match = re.search(r'data-sitekey="([^"]+)"', html)
    if match:
        return match.group(1)

    # Pattern 2: grecaptcha.render call
    match = re.search(r"grecaptcha\.render\([^,]+,\s*\{[^}]*sitekey['\"]?\s*:\s*['\"]([^'\"]+)", html)
    if match:
        return match.group(1)

    # Pattern 3: grecaptcha.execute call
    match = re.search(r"grecaptcha\.execute\(['\"]([^'\"]+)", html)
    if match:
        return match.group(1)

    # Pattern 4: reCAPTCHA script src
    match = re.search(r"recaptcha/api\.js\?render=([^&\"]+)", html)
    if match:
        return match.group(1)

    return None

sitekey = extract_sitekey("https://staging.example.com/qa-login")
print(f"Sitekey: {sitekey}")

Cách 2: DevTools trình duyệt

1. Mở trang đích trong Chrome
2. Nhấn F12 → tab Elements
3. Nhấn Ctrl+F, tìm sitekey
4. Tìm thuộc tính data-sitekey="..."
5. Copy giá trị (chuỗi chữ và số dài 40 ký tự)

Cách 3: Tab Network

1. Mở F12 → tab Network
2. Lọc theo recaptcha
3. Tìm request gửi tới google.com/recaptcha/api2/anchor
4. Lấy tham số k= trong URL — đó chính là sitekey

Cách 4: Kiểm tra định dạng trước khi gửi request

Validate format trước khi gửi, để loại trừ lỗi do copy thiếu ký tự hoặc dính khoảng trắng:

import re

def validate_sitekey(sitekey):
    """Validate sitekey format before API call."""
    if not sitekey:
        raise ValueError("Sitekey is empty")

    # Standard format: 40 alphanumeric + hyphens/underscores
    if not re.match(r'^[a-zA-Z0-9_-]{20,60}$', sitekey):
        raise ValueError(f"Invalid sitekey format: {sitekey}")

    return True

# Use before solving
sitekey = extract_sitekey("https://staging.example.com/qa-login")
validate_sitekey(sitekey)

Xử lý các biến thể reCAPTCHA

reCAPTCHA Enterprise

Sitekey Enterprise trông giống hệt sitekey chuẩn, nhưng thiếu tham số enterprise là nguyên nhân phổ biến nhất trong nhóm lỗi này:

import requests

# Standard reCAPTCHA — loads via recaptcha/api.js
# Enterprise reCAPTCHA — loads via recaptcha/enterprise.js

def detect_enterprise(page_url):
    """Detect if page uses reCAPTCHA Enterprise."""
    resp = requests.get(page_url, timeout=15)
    return "recaptcha/enterprise.js" in resp.text

# Submit with enterprise flag
is_enterprise = detect_enterprise("https://example.com")

data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": sitekey,
    "pageurl": "https://example.com",
    "json": 1,
}

if is_enterprise:
    data["enterprise"] = 1

resp = requests.post("https://ocr.captchaai.com/in.php", data=data)

reCAPTCHA Invisible

Loại này không có checkbox, nên enterprise=1 không giúp gì — dấu hiệu nhận biết nằm ở thuộc tính data-size hoặc lệnh gọi grecaptcha.execute():

def detect_invisible(html):
    """Detect invisible reCAPTCHA."""
    indicators = [
        'data-size="invisible"',
        "grecaptcha.execute(",
        "recaptcha/api.js?render=",
    ]
    return any(i in html for i in indicators)

# Submit with invisible flag
data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": sitekey,
    "pageurl": "https://example.com",
    "invisible": 1,
    "json": 1,
}

Sitekey tải động qua JavaScript

Một số trang chỉ render sitekey sau khi JavaScript chạy xong, nên requests.get() trả về HTML rỗng ở phần này. Dùng trình duyệt thật để lấy đúng giá trị:

from selenium import webdriver
from selenium.webdriver.common.by import By

def extract_dynamic_sitekey(url):
    """Extract sitekey from JavaScript-rendered page."""
    driver = webdriver.Chrome()
    driver.get(url)

    # Wait for reCAPTCHA to load
    import time
    time.sleep(3)

    # Try data-sitekey attribute
    elements = driver.find_elements(By.CSS_SELECTOR, "[data-sitekey]")
    if elements:
        sitekey = elements[0].get_attribute("data-sitekey")
        driver.quit()
        return sitekey

    # Try iframe src parameter
    iframes = driver.find_elements(By.CSS_SELECTOR, "iframe[src*='recaptcha']")
    for iframe in iframes:
        src = iframe.get_attribute("src")
        import re
        match = re.search(r'[?&]k=([^&]+)', src)
        if match:
            driver.quit()
            return match.group(1)

    driver.quit()
    return None

Câu hỏi thường gặp

Sitekey đúng nhưng vẫn báo ERROR_WRONG_GOOGLEKEY, vì sao?

Thường do thiếu cờ đi kèm, không phải sai sitekey: kiểm tra trang có dùng reCAPTCHA Enterprise (thiếu enterprise=1) hoặc Invisible (thiếu invisible=1) trước khi nghi ngờ giá trị sitekey.

reCAPTCHA v2 và v3 có dùng chung sitekey không?

Không. v2 và v3 dùng hai sitekey khác nhau trên cùng một trang. Kiểm tra script reCAPTCHA trong mã nguồn để xác định đang gặp phiên bản nào.

Có nên cache sitekey để đỡ trích xuất lại mỗi lần không?

Chỉ cache ngắn hạn — vài phút đến vài giờ. Một số trang xoay sitekey định kỳ, nên khi tỷ lệ giải bắt đầu giảm, việc đầu tiên cần làm là trích xuất lại sitekey, không phải nghi ngờ API.

Làm sao biết một trang dùng reCAPTCHA Enterprise hay bản chuẩn?

Xem script tải trên trang: bản chuẩn nạp qua recaptcha/api.js, Enterprise nạp qua recaptcha/enterprise.js. Hàm detect_enterprise() ở trên tự động hoá bước này.

Trích xuất được sitekey rỗng thì xử lý thế nào?

Phần lớn do trang render sitekey bằng JavaScript sau khi tải, nên request HTML thuần không thấy được. Dùng Selenium (hoặc công cụ trình duyệt tương đương) thay vì requests.get().

Hướng dẫn liên quan

• Chuẩn hoá tham số request trước khi gửi API
• Cây quyết định xử lý lỗi API CaptchaAI

Lấy đúng sitekey ngay từ đầu — giải CAPTCHA với CaptchaAI.