如何在Composer 1.3中捕获HTTP请求连接错误并返回友好提示

你遇到的流程中断、原生技术报错问题，核心原因是Bot Composer 1.3版本的发送HTTP请求节点默认未开启独立错误分支，节点执行失败时会直接触发全局异常拦截逻辑，中断对话流并抛出系统原生的技术报错，不会自然流转到后续的trace节点。按以下步骤配置即可实现友好的报错替换：

单节点级错误兜底配置（优先落地） #

• 选中流程中的发送HTTP请求动作节点，在右侧配置面板最底部，找到折叠状态的*错误处理（Error Handling）*板块
• 开启「启用错误分支」开关，开启后节点会自动生成独立的错误输出端口：所有非2xx响应、网络连接失败、超时、服务主动拒绝连接等异常场景，都会从这个端口流转，不会再触发全局中断逻辑
• 将正常业务流程的连线从节点的成功输出端口接出，连接到你原本配置的第二个trace节点及后续业务逻辑
• 在节点的错误输出端口连线上，接入「发送消息」动作，配置面向用户的友好提示，比如：「当前关联服务暂时无法访问，请您稍后再尝试操作」
• 可在错误分支上额外添加一个trace节点，留存具体的报错堆栈、请求地址、失败时间等技术信息，供运维排查使用，不会将这类技术细节透传给终端用户

全局异常兜底补充配置 #

• 进入Bot Composer的设置 > 资源配置 > 异常处理页面，将全局默认的异常提示文案替换为统一的友好内容，避免个别节点漏配错误分支时直接暴露原生报错
• 针对网络连接类报错（连接被主动拒绝、请求超时）配置专项匹配规则，触发后直接走统一提示逻辑，跳过原生报错的抛出环节

效果验证方法 #

• 临时将HTTP请求节点的目标端点改成一个不存在的端口地址，模拟服务不可达的宕机场景
• 走通完整对话流程，确认两个效果：一是不会再出现「由于目标计算机主动拒绝连接，无法建立连接」的原生报错，对话流程不会中断；二是用户会收到提前配置的友好提示
• 检查流程日志，确认错误场景的运行痕迹被正常留存，方便后续排查

注意：1.3版本的错误分支配置仅对当前选中的发送HTTP请求节点生效，建议批量梳理流程中所有配置了HTTP请求的节点，统一开启错误分支配置，避免零散出现报错场景

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