1.通过命令行启动客户端报错

• 请确认客户端版本在V2.15.0.1及以上
• 请确认使用的API调用方式是HTTP（SDK模式仅支持通过SDK启动客户端）
• 请确认是否使用管理员身份运行CMD或者PowerShell
• 请确认是否在hubstudio主目录打开，或已进入hubstudio主路径

2.用户中心找不到API-key？

• hubstudio API v1使用API-key验证用户身份，仅在V2.11.0.2及之前的版本使用。

3.一个用户可以在多台机器同时使用api吗？

• 支持，每个机器会占用一个API坐席。

4.程序退出了坐席还没有释放？

• 非正常退出程序不会主动释放坐席，等待5分钟后即可自动释放。命令行启动可直接通过Ctrl+C键或关闭窗口退出，使用代码在后台启动可通过接口关闭程序（详见接口文档 https://3b3d32.bk-free01.com/7beb/fbb0/1d9a）。
• 【http】接口路径：/quit

5.私钥解析失败是什么问题？

• 重新复制一下私钥，如果还是不行，可对比一下私钥开头字符串是否不同，可能是由于机器上有木马病毒将剪切板内容替换导致，建议使用杀毒软件扫描清理后重试。

6.请求接口报连接失败（由于目标计算机积极拒绝，无法连接）是怎么回事？

• 检查一下hubstudio_connector.exe进程是否启动，端口是否正确（默认为6873）。另外如有手动退出Hubstudio客户端会导致接口服务进程退出。

7.自动化（webdriver、playwright等）报连接失败是怎么回事？

• 检查连接端口是否正确，此处端口为打开环境接口返回的debuggingPort字段，非hubstudio_connector.exe进程的服务端口。

8.使用接口服务时，不能同时启动Hubstudio客户端界面？

• 将Hubstudio升级到V3.35.0及以上版本后，API与客户端可同时运行。

9.使用命令行运行hubstudio_connector.exe，请求接口突然没有响应了\程序突然卡住了？

• 因为控制台默认开启了“快速编辑模式”。当“快速编辑模式”开启时，当你的鼠标不小心在界面上点击，就会自动进入编辑模式（可以看到界面上会出现一个表示编辑的光标），可能导致控制台输出阻塞甚至后台程序阻塞。按回车或者 Esc 或者鼠标右键后，程序可恢复继续运行。
• 关闭“快速编辑模式”：在窗口标题栏右键 -> 属性，编辑选项中取消勾选“快速编辑模式”。

10.请求api接口时报错：访问接口超出频率限制是什么问题？

• 接口有请求频率限制，每个接口每分钟最多请求100次，请合理控制请求频率。

11.请求api接口时报错：缺少请求参数

• 请检查参数设置。get接口参数需放在params，post接口参数需要放在body，使用json格式。建议先使用postman调通后再使用脚本调用。

12.请求api接口时报错：用户不属于此团队

• HTTP：命令行Ctrl+C退出程序，填写正确参数后启动。

13.如何进行远程调试？

• hubstudio_connector.exe命令行启动参数增加--remote_debugging可远程调试接口，打开环境参数args加上--remote-debugging-address=0.0.0.0可远程调试环境，远程调试环境仅在无头模式下有效。

14.接口调用支持多线程吗？

• 支持。但目前由于打开环境是基于队列单线程打开，所以多线程请求打开环境可能导致响应较久，建议将打开环境请求的超时时间设置久一些（接口程序的默认超时为600秒，可通过命令行启动参数修改），或者提取打开环境方法加同步锁来防止多线程打开超时。

15.调用打开环境接口耗时较长？

• 打开环境速度和本机网络及环境的代理有关，请检查网络环境。

16."xxxx"启动参数是否支持？/ "xxxx"启动参数打开环境不生效？

• 确认启动参数是通过“打开环境接口”的args参数传入，如传入后不生效则不兼容。

17.打开环境启动参数使用"--load-extension=插件路径"加载本地插件，打开后报错？

• 插件路径需要为插件解压后的文件夹，路径需要双斜杆。

18.为什么无头模式无法打开插件页面？

• 无头模式不支持加载插件。

19.使用api打开环境如何打开环境检测页（社交账号管理系统）界面？

• 获取打开环境接口返回backgroundPluginId字段，打开地址chrome-extension://backgroundPluginId参数/index.html。注意启动参数不能添加禁用插件"--disable-extensions"参数，否则无法打开。

20.为什么打开环境不加载插件？

• 部分插件在低版本内核无法使用，可尝试修改环境内核为最新版本。如使用api打开不加载，检查环境启动参数是否传入禁用插件"--disable-extensions"参数，去除后即可。如上述无法解决可联系客服进行处理。

21.为什么api打开环境不显示图片？

• 检查团队-偏好设置-禁止加载图片是否开启，关闭后即可正常加载。

• 检查环境设置-禁止加载图片是否开启，关闭后即可正常加载。（默认为跟随团队偏好设置）

• 检查环境启动参数是否传入禁止加载图片参数"--blink-settings=imagesEnabled=false"，去除后重新启动即可。

22.为什么偏好设置禁止加载图片\视频，api打开环境仍然加载图片？

• 客户端内禁止加载图片\视频通过自带插件实现，请检查环境启动参数是否传入禁用插件"--disable-extensions"参数，去除后重新启动即可。

23.更新环境后指纹会发生变化吗？

• 不会，指纹是在创建环境时生成，生成后不变。

24.创建环境指定环境分组参数不生效？

• 创建环境时指定的分组需已存在，请先新建分组。

25.如何通过api清除环境cookie？

• 使用导入cookie接口传入空cookie即可，参数参考如下：

{

  "containerCode":"环境id",

  "cookie":"[]"

}

26.使用api打开环境操作并关闭后cookie没有保存下来？/ api打开环境后不能保存登录状态？

• 将打开环境接口参数isWebDriverReadOnlyMode设置为false，默认为true只读。

27.使用api打开环境，每次都会自动打开之前打开的网页，如何关闭？

• 客户端2.19版本前是根据偏好设置打开，可前往客户端，右上角团队-偏好设置-启动环境时 改为“仅检测页”即可关闭。客户端3.0至当前3.6版本默认不会自动打开。

28.python运行webdriver报错executable_path has been deprecated,please pass in a Service object.

• 使用的selenium版本不同，4.0版本selenium需要通过driver = webdriver.Chrome(service=Service(webdriver_path), options=options)创建。

29.使用java对接api，运行时中文乱码导致数据序列化错误。

• 指定UTF-8运行jar包：java -Dfile.encoding=UTF-8 -jar xxx.jar

30.hubstudio_connector.exe启动报错：客户端启动失败:The requested operation requires elevation.

• 使用管理员权限启动即可。

31.hubstudio_connector.exe启动报错：客户端启动失败：open NUL：The system cannot find the file specified.

• 下载null.sys文件，或者找一个和系统版本一样的文件，将文件放到C:\Windows\System32\drivers下（记得保留之前的null.sys文件，以防替换出问题后还可以换回来），重启电脑生效。

32.hubstudio_connector.exe启动报错：查找进程失败：exec：“findstr”：executable file not found in %PATH%.

• 系统环境变量Path变量的问题，需将windows命令的目录添加到Path中，即在Path中追加%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0;%SYSTEMROOT%\System32\OpenSSH;

• win10新建无需加";"，参考下图