解决“无法连接uniCloud本地调试服务,请检查当前客户端是否与主机在同一局域网下”问题

发布于:2025-04-10 ⋅ 阅读:(41) ⋅ 点赞:(0)

一、背景

hbuilder 分别在电脑浏览器和手机app端运行同一个项目,获取图形验证码。

浏览器ok,但是手机app报错。

1、浏览器显示(正常)

2、手机端显示(异常)

浏览AI给出的意见,以及网络上的相关的文档,有了大概的思路。

AI意见:网络连接、网络频段(2.4G 和 5G Wi-Fi 频段)、IP、防火墙、HBuilder本身。

网络文档:Error: 无法连接uniCloud本地调试服务,请检查当前客户端是否与主机在同一局域网下。_error: 无法连接unicloud本地调试服务,请检查当前客户端是否与主机在同一局域网下-CSDN博客

二、3个角度考虑这个问题

1、防火墙

防火墙是否正确关闭

防火墙是否允许应用HBuilder通过

2、非C盘管理员运行HBuilder

最重要的一点(最终破局):很多开发者喜欢把软件安装在非C盘!!!那么运行HBuilder的时候,用管理员身份运行!!!

3、网络

网络是否成功连接?

注意:不是都连在一个wifi下,就叫做成功连接。必须是两者可以ping通

三、开始切入

1、关闭防火墙

先关防火墙。这样下一阶段ping的时候才好测试。

防火墙有:公用防火墙、专用防火墙、XXX防火墙。留意你当前连接的网络是属于哪一个防火墙。

(1)具体看电脑右下标 - 连接的网络 - 感叹号 - 点击

(2)或者直接搜索防火墙,哪里显示(使用中),就是哪个。

(3)嫌麻烦的就全部都关了。

2、防火墙允许应用HBuilder通过

操作参考:Error: 无法连接uniCloud本地调试服务,请检查当前客户端是否与主机在同一局域网下。_error: 无法连接unicloud本地调试服务,请检查当前客户端是否与主机在同一局域网下-CSDN博客

3、用管理员身份运行HBuilder

开发人员非常喜欢把软件安装在非C盘,导致只能拥有部分权限。

4、网络ping测试通过

手机需要额外的app来辅助ping测试,我在小米商店下载了一个 《网络工具》。

(1)网络配置1(不成立)

网络配置:一台手机开流量和热点、一台手机运行APP、一台电脑启动HBuilder。

先说ping测试结论:电脑可以ping到手机的ip。手机可以ping电脑的ip,但是速度非常慢。然后获取图形验证码的时候会导致显示另外一个错误信息。

控制台同时报错:连接本地调试服务失败,请检查客户端是否和主机在同一局域网下,自动切换为已部署的云函数。

具体操作:

电脑ip:打开cmd - 输入 ipconfig - 无线局域网适配器 WLAN

手机ip:设置 - 我的设备 - 全部参数与信息 - 状态信息 - IP地址

电脑ping手机:

手机ping电脑:

(2)网络配置2(成立)

网络配置:一台手机、一台电脑。手机开流量和热点,并运行APP。电脑连这个手机的热点,运行HBuilder。

先说ping测试结论:电脑可以ping到手机的ip。手机可以ping电脑的ip。手机app可以正确获取到图形验证码。

具体操作:

电脑ip:

手机ip:可以用刚刚下载的《网络工具》里面的“你的ip”获取。

电脑ping手机:

手机ping电脑:

0%的丢包率!!!

5、回归APP查看图形验证码

6、再次检查浏览器的验证码