运行项目到浏览器 Network: unavailable 怎么解决呢？

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

运行项目到浏览器时显示 Network: unavailable，通常是因为本地开发服务器没有正确获取到局域网 IP，或者网络配置/权限问题。可以按以下步骤排查：

1. 检查网络连接
   确保电脑已连接到网络（Wi-Fi 或有线）。如果完全断网，HBuilderX 无法生成本地服务地址，会显示 Network: unavailable。

2. 以管理员身份运行 HBuilderX
   右键 HBuilderX 图标，选择“以管理员身份运行”。某些系统权限或安全软件会阻止 HBuilderX 获取网络接口信息。

3. 检查防火墙/安全软件
   暂时关闭 Windows 防火墙、杀毒软件或第三方安全工具，然后重新运行项目。这些软件有时会拦截本地服务的网络请求。

4. 手动指定浏览器运行
   在 HBuilderX 中，尝试通过菜单 运行 -> 运行到浏览器 -> Chrome（或其他浏览器），看是否能正常打开。如果默认浏览器有问题，可以手动指定。

5. 检查 hosts 文件
   打开 C:\Windows\System32\drivers\etc\hosts，确保没有注释掉 127.0.0.1 localhost 或 ::1 localhost，且没有异常的重定向。

6. 重置网络或更换网络环境
   尝试切换网络（如从 Wi-Fi 切换到手机热点），或重启路由器。某些公司内网或校园网会限制本地端口访问。

7. 重新安装 HBuilderX
   如果以上方法无效，可能是 HBuilderX 安装文件损坏。建议卸载后重新下载最新版 HBuilderX 安装。

如果问题依旧，可以查看 HBuilderX 的运行日志（菜单：帮助 -> 查看运行日志），根据日志中的错误信息进一步排查。

相关参考：

• web浏览器预览h5项目，Network: unavailable
• network：unavailable

一条条都来过了 还不不行

2026-09-07 08:58:43.304 [INFO:] Execute command: "setContext"
2026-09-07 08:58:43.306 [INFO:] Execute command: "setContext"
2026-09-07 08:59:06.192 [INFO:] [Thread] The object move to thread occur in (JobManager::runInStandaloneThread<T>)
2026-09-07 08:59:06.764 [INFO:] [Thread] The object move to thread occur in (JobManager::runInStandaloneThread<T>)
2026-09-07 08:59:09.129 [INFO:] [Thread] The object move to thread occur in (JobManager::runInStandaloneThread<T>)
2026-09-07 08:59:09.137 [INFO:] appCheck start
2026-09-07 08:59:09.137 [INFO:] appCheck processing 20%
2026-09-07 08:59:09.151 [WARNING:] [PluginHost] 'wmic' �����ڲ����ⲿ���Ҳ���ǿ����еij���
���������ļ���

2026-09-07 08:59:09.669 [INFO:] appCheck processing 40%
2026-09-07 08:59:09.669 [INFO:] appCheck processing 60%
2026-09-07 08:59:09.670 [INFO:] appCheck processing 80%
2026-09-07 08:59:09.673 [INFO:] appCheck processing 100%
2026-09-07 08:59:10.030 [INFO:] appCheck finished 这个是运行日志