Hoppscotch 浏览器插件请求失败排查指南5 步【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch在浏览器里的 Hoppscotch 页面点下发送浏览器插件请求失败请求转了几秒圈响应区只留下一行Agent not detected或者整页毫无反应。你的第一反应多半是网络又抽风了但断点通常不在你到目标 API 的路上而在浏览器和你这台本机之间。Hoppscotch 是跑在网页里的 API 测试工具真正发出请求的是一条由本地 Agent 中继服务默认端口9119搭的通道这篇就顺着这条通道把断点找出来。浏览器为什么要请本地服务代劳浏览器像一间门禁严格的办公室只允许跟同一栋楼同源的窗口递东西发给其他域名、本机或内网服务的请求都在门口被扣下。本地 Agent 就是外派的取件员浏览器把包裹交给它它凭加密通道这张工牌替你把请求送到 API 门口再把回执带回来。注册、端口、通路这三关查的就是这位取件员在不在岗、有没有工牌、能不能走出大门。 确认本地中继进程还在托盘里症状页面弹出Agent not detected请求直接超时没有明确的网络报错。原因Agent 没在运行或装完后被更新、杀软顺带关掉了便携版不会自动启动最容易栽在这里。动作看系统托盘里有没有 Hoppscotch 图标没有就从安装目录手动拉起程序。启动后右键托盘图标选Show Registrations能看到网页端的会话记录说明进程侧没问题往下看注册。 用 6 位验证码重走 OTP 注册症状进程活着但页面依然发不出请求或提示 Failed to initiate the registration。原因OTP 握手没完成或验证码已过期。注册码一次性、有效期很短放着不管就作废。动作进 Settings → Interceptors选 Agent点 Register AgentAgent 窗口弹出 6 位验证码把它填进 OTP 输入框并确认。窗口自动收起、显示掩码后的 auth key 哈希即注册成功。验证码过期就重新发起一轮页面没出现 OTP 输入框时先把 Agent 窗口点到最前面。 检查 9119 端口占用并放行防火墙症状注册成功了请求照样超时或握手明显卡在半路。原因两类端口被别的程序占了或防火墙拦了本地9119还有个隐蔽项是浏览器兼容性——macOS 上的 Safari 对 localhost 的访问控制经常触发 CORS 拦截同样的请求换 Chrome 就正常。动作macOS/Linux 执行lsof -i :9119Windows 用netstat -ano | findstr 9119看端口归属被占用就结束占用进程再重启 Agent并在防火墙里放行该端口。用 Safari 的话换 Chrome 或 Firefox 完成注册和验证。 配置代理与客户端证书只有这两种情况才看症状请求只对某个目标域名失败要么它要走内网网关代理要么要求 mTLS 客户端证书。原因Agent 支持按域名配置全局默认挂在*域下特定域名可以单独加一条覆盖。没配的话该域名的请求按默认策略发出去网关或 CA 端自然拒收。动作在 Agent 配置里先选中目标域名再设置代理项填 URL必须带http://或https://协议头和账号密码证书选.pem时证书与私钥是两个文件.pfx是单文件加密码顺手核对私钥与证书是否匹配、verify host / verify peer 开关是否符合目标环境。自建实例场景同样走这套按域名的方式对照清单逐条过一遍托盘里是否有 Agent 图标进程是否存活Settings → Interceptors 里 Agent 的 6 位验证码是否注册成功9119 端口是否被其他程序占用、防火墙是否放行若在用 Safari是否已换 Chrome/Firefox 复测目标域名涉及代理或证书时是否查了该域名的单独配置而非全局默认【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hoppscotch 浏览器插件请求失败排查指南（5 步）
Hoppscotch 浏览器插件请求失败排查指南5 步【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch在浏览器里的 Hoppscotch 页面点下发送浏览器插件请求失败请求转了几秒圈响应区只留下一行Agent not detected或者整页毫无反应。你的第一反应多半是网络又抽风了但断点通常不在你到目标 API 的路上而在浏览器和你这台本机之间。Hoppscotch 是跑在网页里的 API 测试工具真正发出请求的是一条由本地 Agent 中继服务默认端口9119搭的通道这篇就顺着这条通道把断点找出来。浏览器为什么要请本地服务代劳浏览器像一间门禁严格的办公室只允许跟同一栋楼同源的窗口递东西发给其他域名、本机或内网服务的请求都在门口被扣下。本地 Agent 就是外派的取件员浏览器把包裹交给它它凭加密通道这张工牌替你把请求送到 API 门口再把回执带回来。注册、端口、通路这三关查的就是这位取件员在不在岗、有没有工牌、能不能走出大门。 确认本地中继进程还在托盘里症状页面弹出Agent not detected请求直接超时没有明确的网络报错。原因Agent 没在运行或装完后被更新、杀软顺带关掉了便携版不会自动启动最容易栽在这里。动作看系统托盘里有没有 Hoppscotch 图标没有就从安装目录手动拉起程序。启动后右键托盘图标选Show Registrations能看到网页端的会话记录说明进程侧没问题往下看注册。 用 6 位验证码重走 OTP 注册症状进程活着但页面依然发不出请求或提示 Failed to initiate the registration。原因OTP 握手没完成或验证码已过期。注册码一次性、有效期很短放着不管就作废。动作进 Settings → Interceptors选 Agent点 Register AgentAgent 窗口弹出 6 位验证码把它填进 OTP 输入框并确认。窗口自动收起、显示掩码后的 auth key 哈希即注册成功。验证码过期就重新发起一轮页面没出现 OTP 输入框时先把 Agent 窗口点到最前面。 检查 9119 端口占用并放行防火墙症状注册成功了请求照样超时或握手明显卡在半路。原因两类端口被别的程序占了或防火墙拦了本地9119还有个隐蔽项是浏览器兼容性——macOS 上的 Safari 对 localhost 的访问控制经常触发 CORS 拦截同样的请求换 Chrome 就正常。动作macOS/Linux 执行lsof -i :9119Windows 用netstat -ano | findstr 9119看端口归属被占用就结束占用进程再重启 Agent并在防火墙里放行该端口。用 Safari 的话换 Chrome 或 Firefox 完成注册和验证。 配置代理与客户端证书只有这两种情况才看症状请求只对某个目标域名失败要么它要走内网网关代理要么要求 mTLS 客户端证书。原因Agent 支持按域名配置全局默认挂在*域下特定域名可以单独加一条覆盖。没配的话该域名的请求按默认策略发出去网关或 CA 端自然拒收。动作在 Agent 配置里先选中目标域名再设置代理项填 URL必须带http://或https://协议头和账号密码证书选.pem时证书与私钥是两个文件.pfx是单文件加密码顺手核对私钥与证书是否匹配、verify host / verify peer 开关是否符合目标环境。自建实例场景同样走这套按域名的方式对照清单逐条过一遍托盘里是否有 Agent 图标进程是否存活Settings → Interceptors 里 Agent 的 6 位验证码是否注册成功9119 端口是否被其他程序占用、防火墙是否放行若在用 Safari是否已换 Chrome/Firefox 复测目标域名涉及代理或证书时是否查了该域名的单独配置而非全局默认【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考