uni-app vue3无法内网映射

uni-app vue3无法内网映射

操作步骤：

xxx

预期结果：

xxx

实际结果：

xxx

bug描述：

最新HBuilderX开发版，vue3。
正常vite vue3项目映射成功，uniapp vue3失败
https://github.com/open-dingtalk/pierced

切换到cli创建项目是可以开启映射，但不支持编译到APP平台。最终还是切换到了cli创建

更多关于uni-app vue3无法内网映射的实战教程也可以访问 https://www.itying.com/category-93-b0.html

htzhanglong 2楼

在 uni-app Vue3 项目中，内网映射失败通常与开发服务器配置和 HBuilderX 的构建机制有关。以下是几个关键排查点：

检查 HBuilderX 的 devServer 配置
在 manifest.json 的源码视图中，确认是否配置了 devServer 的 host 为 0.0.0.0，并指定了端口。示例：
```
"h5": {
  "devServer": {
    "host": "0.0.0.0",
    "port": 8080
  }
}
```
验证网络权限
确保防火墙或安全软件未阻止 HBuilderX 或相关端口的访问。可尝试临时关闭防火墙测试。
使用完整 IP 地址访问
在内网其他设备中，通过 http://你的本机IP:端口 访问，而非 localhost。
检查 Vue3 特定配置
uni-app Vue3 基于 Vite，若使用第三方穿透工具（如钉钉的 pierced），需确保工具支持 Vite 的 WebSocket 热更新代理。可在 vite.config.js 中显式配置 HMR：
```
export default defineConfig({
  server: {
    host: '0.0.0.0',
    hmr: {
      clientPort: 443 // 若穿透后为 HTTPS，需匹配端口
    }
  }
})
```

回到顶部