安装软件后默认的页面就无法进行预览-华为开发者问答

重启试试君

技术支持

尊敬的开发者，您好，
我这边用DevEco Studio 6.1.0 Release，新建一个基础的hello world页是可以正常预览的，没有出现预览报错，
根据图示报错，您也可尝试以下步骤进行修复：
1、重启IDE：有时候，简单地重启你的集成开发环境（IDE）可以解决这个问题。关闭并重新打开DevEco Studio或你正在使用的其他IDE。

2、清理缓存和重建项目：在IDE中，选择“Build”->“Clean Project”，然后再次尝试构建你的项目。

3、更新IDE和SDK：确保你的DevEco Studio和HarmonyOS SDK都是最新版本。过时的版本可能会导致兼容性问题。

4、检查防火墙设置：hvigor服务可能被防火墙阻止。检查你的防火墙设置，确保它没有阻止hvigor服务。

您这边参考以上步骤仍无法解决问题，是否方便提供以下信息方便我们进一步定位分析问题：
1、复现问题的DevEco Studio版本号
2、DevEco Studio报错日志：点击DevEco Studio的菜单项Help->Compress Logs and Show in Explorer获取日志，查看devecostudio-logs-xxx-xxx.zip压缩包
2、电脑系统及版本

6楼回复于2026-06-26 03:05 来自广东

蓝瘦的蜕变

我这边试了下是正常的，建议使用重启大法再试试，或者重装DevEco Studio，如果还不能解决您的问题，建议附上DevEco Studio版本号以及对应的SDK版本提交工单进行反馈：在线提单

1楼回复于2026-06-25 03:43 来自广东

匿名用户
我只能说真牛逼，默认安装，鸿蒙给的默认示例代码都无法预览
2026-06-25 03:51 来自河南

小鹿

开发者您好，重新下载最新版DevEco Studio，退出所有杀毒软件，再执行安装程序，保持默认路径，安装完后启动时也不要开启杀毒软件。

4楼回复于2026-06-25 10:14 来自山东

橙动创意

默认 hello world 都预览失败时，优先按 IDE/预览构建环境排查，不像是页面代码问题。

建议先打开 Preview/Build 输出，看第一条真实错误；检查 hvigor daemon 是否正常、端口是否被安全软件/代理占用、SDK 是否完整安装、项目路径是否有中文/特殊权限问题。可以关闭 IDE 后清理项目下 `build`、`.hvigor`，再重启 DevEco Studio 同步工程。若新建空项目也同样失败，再考虑修复 SDK 或重装 IDE。

8楼回复于2026-06-29 01:04 来自四川

FIEforever

重装试试

7楼回复于2026-06-26 09:30 来自广东

仙银

你好，参考预览器触发构建，编译时发生daemon相关报错。

问题原因：

hvigor尝试申请的端口范围(45000-45099)，所有端口都被占用或无权限
daemon进程被安全软件拦截，例如公司安全软件、VPN、流量代理、杀毒软件
hvigor没有用户目录下缓存路径的访问权限，或缓存文件损坏

解决方案

检查确保端口(45000-45099)可用，检查本机路径访问权限可用，测试：
收起
自动换行
深色代码主题
复制
```
> netstat -ano | findstr 450

> ping 127.0.0.1
```
检查并关闭可能会拦截的安全软件
删除以下缓存目录：
1. Windows: C:\Users\<用户名>\.hvigor
2. Linux/macOS: ~/.hvigor
如果以上方式仍然报错，卸载现有 DevEco Studio并执行默认安装后，重新创建项目后尝试预览

5楼编辑于2026-06-25 11:43 来自四川

不羁的木木

看截图这个不像是代码问题，默认 HelloWorld 页面本身没问题。主要看底部报错：

收起
自动换行
深色代码主题
复制
hvigor Create hvigor server failed

AdaptorError:
SessionIdHelper.readDirBytes

这个属于 DevEco Studio 的 hvigor 构建服务启动失败，预览器依赖 hvigor 生成预览资源，所以 hvigor 起不来时，右侧预览就会直接失败。

可以按下面排查：

1. 先确认 Node 环境

截图里用的是：

收起
自动换行
深色代码主题
复制
D:\software\DevEco Studio\tools\node\node.exe

说明用的是 DevEco 自带 Node。

先在 DevEco Terminal 执行：

收起
自动换行
深色代码主题
复制
node -v

再：

收起
自动换行
深色代码主题
复制
hvigorw --version

如果 hvigor 命令异常，基本就是环境问题。

2. 删除 hvigor 缓存重新生成

关闭 DevEco Studio。

删除项目下面：

收起
自动换行
深色代码主题
复制
hvigor

目录（如果有）

以及：

收起
自动换行
深色代码主题
复制
.gradle

然后删除用户缓存：

Windows：

收起
自动换行
深色代码主题
复制
C:\Users\你的用户名\.hvigor

重新打开项目：

执行：

收起
自动换行
深色代码主题
复制
hvigorw clean

再打开 Preview。

3. 检查项目路径

这个问题 Windows 下比较常见。

不要放：

收起
自动换行
深色代码主题
复制
D:\xxx\中文目录\项目

也不要：

收起
自动换行
深色代码主题
复制
D:\Program Files\

建议：

收起
自动换行
深色代码主题
复制
D:\HarmonyProjects\TestApp

路径不要中文、不要空格。

4. 检查杀毒/权限

你的报错：

收起
自动换行
深色代码主题
复制
SessionIdHelper.readDirBytes

经常是 hvigor 创建临时文件失败。

试一下：

右键 DevEco Studio：

收起
自动换行
深色代码主题
复制
以管理员身份运行

如果能正常预览，说明就是权限问题。

5. 清理 DevEco 索引

菜单：

收起
自动换行
深色代码主题
复制
File
 → Invalidate Caches
 → Invalidate and Restart

重启后等待重新索引。

6. 如果刚安装 DevEco Studio

确认 SDK 是否完整。

打开：

收起
自动换行
深色代码主题
复制
File
 → Settings
 → SDK Manager

检查：

HarmonyOS SDK
Previewer
Toolchains

是否安装。

从你截图看，我优先怀疑：

项目路径/权限问题
hvigor 缓存损坏
DevEco 自带 Node 环境异常

因为代码就是模板 HelloWorld，ArkUI 本身不会导致 PreviewBuild 直接挂。你可以先删 .hvigor + 换一个纯英文路径项目试一下，很多这种安装后第一次打开预览失败都是这个原因。

展开全部

3楼回复于2026-06-25 08:21 来自辽宁

阿家

逐步排查，每完成一步后重新尝试预览：

查看 PreviewerLog 错误日志
禁用 Hvigor 守护进程
修复 Node 服务错误（检查 hosts、重启 winnat、检查 nodejs.dir 路径）
清除缓存并重新构建
检查项目路径和环境变量
检查代码问题（@Entry、动态装饰器、不兼容 API）
检查预览器文件完整性
禁用 GPU 加速
更新 DevEco Studio

如果以上方法均未能解决问题，建议收集日志信息，通过 Help → Contact Support联系华为技术支持或提单

2楼回复于2026-06-25 07:13 来自北京