net 常见问题

端口被占用怎么办

启动监听时如果端口已被其他程序占用，服务会启动失败。请换一个端口，或关闭占用该端口的进程。

localhost 和 127.0.0.1 有什么区别

127.0.0.1 固定表示 IPv4 本机回环地址。localhost 是主机名，系统会解析到本机地址，可能包含 IPv4 或 IPv6。需要行为稳定时建议在本机测试中直接使用 127.0.0.1。

连接超时如何处理

TCP 客户端支持 timeout，单位毫秒。

UDP 没有连接确认机制，send() 成功不代表远端一定收到。

Windows 防火墙是否会影响

会。监听 0.0.0.0 或局域网地址时，Windows 防火墙可能阻止外部设备访问。只做本机通信时优先绑定 127.0.0.1。

Web 服务和 reqwest 有什么区别

net.listen({type:'web'}) 是启动服务端，接收外部请求。reqwest(url) 是 HTTP 客户端，用于主动请求其他 HTTP 服务。

bt_app 中使用本地端口要注意什么

桌面应用中常见做法是 BT 后端监听 127.0.0.1:<port>，前端页面连接这个本地端口。请确保端口固定且未被占用；如果端口由程序选择，需要把实际端口传给前端。

为什么脚本不会自动退出

TCP、UDP、WebSocket 和 Web 服务会启动后台任务。只要后台服务还在运行，BT 进程会保持常驻。需要退出时调用返回对象的 close()，或结束进程。

如何查看本机 IP

net.local_ip() 会优先返回默认出口 IP，探测失败时返回 127.0.0.1。