Java调用Capsolver TwoCaptcha遇ERROR_WRONG_USER_KEY问题求助

问题描述 #

我尝试用Java代码解决谷歌reCAPTCHA演示页面的验证码，代码如下：

String apiKey = "CAP-XXX";
String Link = "http://google.com/recaptcha/api2/demo";
TwoCaptcha solver = new TwoCaptcha(apiKey);
ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://google.com/recaptcha/api2/demo");
captcha.setInvisible(true);
captcha.setAction("verify");
driver = OpenBrowser(); // Opens the browser ;)
driver.get(Link);
wait_own(2000);
try {
    solver.solve(captcha);
    System.out.println("Captcha solved: " + captcha.getCode());
} catch (Exception e) {
    System.out.println("Error occurred: " + e.getMessage());
}

代码里的API密钥在浏览器手动调用时正常可用，但运行代码时却捕获到ERROR_WRONG_USER_KEY错误。已排除密钥本身无效的可能，想请教还有哪些排查方向？

排查建议 #

• 检查密钥的完整性与格式：确认代码中填写的密钥和手动使用的完全一致，没有多余空格、换行或字符遗漏。部分服务商对密钥的大小写、特殊字符处理严格，需确保无输入失误。
• 验证密钥的调用来源限制：很多验证码服务商的API密钥会绑定允许的IP地址、域名或设备。手动调用时的IP可能在白名单内，但代码运行的服务器/本地IP未被授权，导致密钥被判定无效。
• 更新TwoCaptcha SDK版本：旧版本的Java客户端可能存在密钥解析或请求处理的bug，尝试升级到最新版本的SDK，避免因版本兼容问题引发密钥验证失败。
• 确认API端点环境匹配：若服务商区分测试环境与生产环境，检查代码是否误使用了与密钥不匹配的环境端点（比如用测试环境端点调用生产密钥，反之亦然）。
• 排查代码中的密钥覆盖问题：查看是否有其他代码逻辑在初始化TwoCaptcha实例后修改了apiKey变量，或存在变量名冲突导致密钥被意外替换。
• 核对密钥的类型权限：确认你的API密钥支持reCAPTCHA类型的任务，部分服务商的密钥会区分普通图像验证码、reCAPTCHA等不同任务类型，权限不匹配也会触发无效密钥错误。

内容的提问来源于stack exchange，提问作者Jocken