影刀RPA报错排查手册SSL证书错误与请求被拦截的处理用影刀RPA的HTTP请求指令调公司内部接口突然报ssl connection could not be established或者客户端同步应用一直失败日志里全是443端口握手错误——这两个问题我都在客户环境里撞过而且都不是流程写错了是机器的证书和网络配置出了状况。这篇按排查顺序把SSL证书错误和请求被拦截的处理路径讲透。这类问题的迷惑性在于报错在流程里根因在系统里。你在影刀RPA里改一百遍HTTP请求参数都没用得去动Windows的网络和证书配置。先分清两种报错形态遇到SSL相关的失败第一步看报错发生在哪一层报错位置典型关键词问题层流程内HTTP请求指令ssl connection could not be established目标站点证书问题客户端登录/同步应用api.winrobot360.com:443本机与影刀服务端链路邮件指令连接邮箱IMAP SSL 连接失败邮箱服务器配置三层的处理方法完全不同别一上来就重装系统。下面逐层展开。情形一私有云/内部系统的证书不被信任私有云环境下同步应用报ssl connection could not be established把请求地址贴到浏览器里访问浏览器也提示不安全——这个现象基本锁死根因机器上的根证书节点验证不通过。原理不复杂HTTPS在TLS握手时会校验证书链操作系统预装了几个大签名公司的根证书证书能顺着链找到已信任的根节点就通过。私有云场景很多是自己给自己签发的证书没有装进操作系统认证自然失败。修复步骤官方文档的原始路径从浏览器把对应站点证书导出到桌面或任意位置双击导出的证书文件选择安装到根节点证书受信任的根证书颁发机构重启影刀客户端重新尝试同步应用我第一次处理时漏了第3步装完证书反复点同步都失败重启客户端立刻通了。证书改动对运行中的进程不即时生效务必重启。情形二TLS协议版本被关闭另一类报错在日志里能搜到给函数提供的标志无效或者443端口握手失败但证书本身没问题。这种情况查TLS 1.2协议有没有被禁。排查与修复打开注册表编辑器定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client检查Enabled的值改成1重启机器再验证这个问题多是代理工具或安全软件修改注册表导致的。改注册表前先备份改完重启。情形三本地代理拦截了请求登录报由于目标计算机积极拒绝,无法连接。(127.0.0.1:1080)——127.0.0.1加端口这是本地代理在劫持请求。科学上网工具、抓包工具Fiddler、Charles开着都会这样。关闭代理要检查三个地方缺一个都可能没关干净设置 → 网络和Internet → 代理把手动设置代理开关调为关闭最好也关掉自动检测设置控制面板 → Internet属性 → 连接 → 局域网设置关闭代理服务器环境变量计算机属性 → 高级系统设置 → 环境变量找到proxy相关的变量删除我遇到过一个隐蔽案例三处都关了还报错最后发现环境变量里残留了一个http_proxy删掉才好。HTTP请求指令被代理拦的时候报错信息里的IP和端口是最好的线索。情形四IPv6导致的握手失败日志同时出现这些内容接口路径WebService:api/v1/sys/client/clientConfig、报错提供了一个无效的参数、目标api.winrobot360.com:443——这是本机用IPv6方式连接导致客户端无法与服务器建立安全连接。修复手动添加系统环境变量DOTNET_SYSTEM_NET_DISABLEIPV61然后重启影刀。一条环境变量解决不用动网络配置。情形五网络模块本身损坏报错关键词System.Net.Sockets.SocketException (10107): 系统调用失败——Windows提供网络能力的模块winsock损坏了。表现为所有网络指令都失败不光是SSL。修复以管理员身份运行cmd输入netsh winsock reset然后重启电脑。重置winsock不影响正常网络使用放心执行。邮件指令里的SSL开关和SSL直接相关的指令还有一个容易被忽略获取邮件。自定义邮箱时需要设置指定的IMAP服务器地址、IMAP端口号以及是否使用SSL连接IMAP服务器这个开关。邮箱端口SSL163/126/QQ邮箱下拉直接选默认配置| 企业自建邮箱 | 993SSL或143 | 按服务器要求 |邮箱连接报SSL错时先确认端口号和SSL开关是否匹配——993端口配了不加密连接或者143端口强开SSL都会握手失败。授权码没开也会报类似错别混淆。流程层面的请求兜底设计环境修好后流程本身也要给网络请求上保险。我的标准写法importrequestsimporttimedefget_data_with_retry(url,max_retry3):# verifyTrue保持证书校验禁止关校验来绕过SSL错误foriinrange(max_retry):try:resprequests.get(url,timeout10,verifyTrue)# 状态码非200直接抛出交给上层Try-Catch统一处理resp.raise_for_status()returnresp.json()exceptrequests.exceptions.SSLErrorase:# SSL错误单独记录这类错误重试通常无效要人工处理raiseException(fSSL握手失败请检查证书配置:{e})exceptrequests.exceptions.RequestException:# 网络抖动类错误等2秒重试time.sleep(2)raiseException(f重试{max_retry}次仍失败:{url})关键原则永远不要用verifyFalse去绕SSL错误。关掉校验流程确实能跑但等于裸奔在客户环境是安全事故。正确姿势是把证书装进系统。捕获到的接口数据如果是JSON影刀里的处理路径是HTTP请求返回文本 → JSON解析指令转成字典 → 按键取值。键可能不存在的字段用字典的默认值方案避免半路断掉。JSON数据处理与写入链路证书修通只是第一步接口数据的处理链路也要规范。我的标准路径HTTP请求指令返回文本 → 「JSON解析」指令转成字典 → 按键取值 → 写入Excel或飞书多维表格。嵌套结构的取值注意层次接口返回一般是{code, data:{list:[…]}}这种组合先取data再取list列表用For循环遍历。字段缺失是常态用字典的默认值方案取别让一个空字段断掉整晚采集。日期时间字段从接口拿到的是时间戳用日期时间指令转格式别直接写进表格——Excel里日期偏移的问题多半就是这么来的。写入层做幂等以订单号或URL做主键写前先查存在性重复数据自动跳过。SSL这类故障恢复后重跑不会产生重复数据这是长跑流程的基本素养。变量与异常的组合拳涉及网络请求的流程变量设计上要留案发现场请求的URL、返回状态码、报错时间全部存进变量再拼进日志。我见过太多日志只写请求失败四个字第二天根本不知道是哪个接口、什么原因。异常处理的结构上把单个接口的请求解析封装成子流程返回成功标志和数据两个输出。主流程里用If判断成功标志失败就走重试或告警分支。这样证书过期、接口改版、网络抖动三类问题都能被隔离在子流程内部主流程结构不动。请求被拦截的另一面目标网站的风控SSL错误要和请求被目标网站拦截区分开。返回403是站点拒绝IP被拉黑或请求头缺失429是请求过频。这类拦截的修法在请求头补齐User-Agent、Referer、Cookie降低请求频率加随机延迟。SSL是握手阶段就失败403/429是握手成功后业务层拒绝——看报错关键词就能分清别把风控当证书问题修。系统联动与日常巡检证书是有有效期的内网自签证书尤其常过期。我在飞书群里挂了个巡检任务每周跑一次「HTTP请求」访问公司内部系统首页握手失败就推Webhook消息。这样证书过期是提前收到通知而不是采集流程半夜集体爆炸。工程化上再补两条涉及内网接口的子流程单独封装证书问题只影响一个模块每个流程的参数表里加一列接口依赖交接文档里写清楚哪些环境变量和证书是前置条件换机器部署时照单检查。易错速查表报错关键词根因修复ssl connection could not be established自签证书未信任导出证书装入根节点并重启影刀127.0.0.1:1080 积极拒绝本地代理劫持三处关闭代理删环境变量给函数提供的标志无效TLS 1.2被禁注册表Enabled改1提供了一个无效的参数IPv6握手失败环境变量禁用IPV6SocketException 10107winsock损坏netsh winsock reset后重启学习资源与延伸阅读证书导入、注册表路径这些操作第一次做都会手生官方FAQ文档里对照截图走一遍就熟了。我把自己的SSL排查决策树、带证书校验的请求封装模块源码放在代码仓库 home.linyan.cloud可以直接参考改造尤其是那个证书巡检子流程改个内网地址就能挂到你的定时任务里。#影刀RPA #RPA自动化 #HTTP请求 #报错排查 #API对接作者林焱