如何解决NeutralinoJS应用运行时出现白屏的问题?
NeutralinoJS 执行
neu run白屏问题解决方案 - 第一步:校验入口配置正确性
打开项目根目录下的neutralino.config.json文件,确认documentPath字段指向的入口HTML文件路径正确,默认空白项目该配置应为/resources/index.html,路径拼写错误、目标HTML文件不存在都会直接触发白屏。 - 第二步:确认前端资源状态
如果是对接Vue、React等前端框架的项目,需要先执行对应框架的构建命令,将打包后的产物输出到配置指定的resources目录下,再执行neu run,未构建就直接启动会找不到前端资源导致白屏。 - 第三步:开启调试模式定位报错
执行neu run --debug命令启动应用,启动后会自动打开Chromium开发者工具,可通过控制台面板查看JS报错、网络面板查看资源加载失败信息,直接定位具体问题。 - 第四步:校验WebView2运行时状态
NeutralinoJS依赖系统Edge WebView2运行时渲染页面,若本地未安装或运行时版本过低也会出现白屏问题,你执行的CheckNetIsolation.exe命令仅用于解决WebView2的网络隔离问题,大部分白屏故障和该配置无关。 - 第五步:清理缓存重试
先终止所有Neutralino相关进程,删除项目根目录下的.neu缓存文件夹后重新执行neu run,旧缓存文件损坏也可能导致资源加载异常。
内容的提问来源于stack exchange,提问作者sotnab
相关产品推荐
相关产品推荐

