使用Vue Router路由懒加载引发的生产页面白屏问题的解决方法

 更新时间:2025年09月18日 08:33:37   作者:FarmerLiusun  
这篇文章主要介绍了使用Vue Router 路由懒加载引发的生产页面白屏问题的原因和解决方法,并有相关的代码示例和图文供大家参考,需要的朋友可以参考下

1.项目技术栈

项目使用vue3 + Vue Router + ant-design-vue,构建工具使用 vite.

  • 框架: vue3
  • 组件库: andt-design-vue
  • 路由: Vue Router
  • 构建工具: vite

2.问题现象

  • 1.本地开发阶段,一切正常没有任何问题。
  • 2.通过nginx部署到开发环境后,访问该前端,其他所有功能均正常无任何问题。
  • 3.当访问/deviceMgmt/deviceLogQuery页面时,页面白屏,控制台无任何报错。

3.问题排查

刚看到这个问题还是挺懵的,自己本地开发环境没有问题,一部署到开发环境就出问题,而且还是没有任何报错、警告、提示。根据上面的现象,初步想到以下几个可能造成该问题的原因:

3.1 路径问题

  • 前端访问的路径写错了
  • 路由配置的路径跟组件的路径写错了

但是通过仔细对比发现,路由配置路径跟组件路径都没有任何问题,故排除了路径问题

3.1 路由配置问题

查看页面元素发现,访问/deviceMgmt/deviceLogQuery路径时,app容器内的组件为空。 并且之后发现之前部署的上一个前端版本是没有问题的,但是只要换成现在重新编译的版本就有这个问题。

通过git版本对比发现,原来是路由懒加载的配置写错了造成的

   // router>index.js
    const routes = [
        {
          name: 'deviceLogQuery',
          path: '/deviceMgmt/deviceLogQuery',
          //✅ 正确写法
          // component: () => import('../views/deviceLogQuery/test.vue'),
          // ❌ 错误写法
          component: import('../views/deviceLogQuery/index.vue'),
        }
    ]

路由配置中如果使用路由懒加载,呢组件的导入配置,component 是通过() => import(./MyPage.vue) 的方式导入。 这里少了 () => ,直接导入了。

4.问题解决

通过git版本对比发现,原来是路由懒加载的配置写错了

并且仔细查看控制台发现原来Vue Router 已经报警提示了:但是只在第一次加载才会报警告😰(自己没仔细看)

修改配置,重新打包部署,问题解决。

5.总结

  • Vue Router 路由懒加载引发的生产页面白屏问题: 是由于路由懒加载的配置写错造成的
  • 写代码的过程: 需要更加细致,原本是一个很小的问题,就是不够仔细才发生
  • git的重要性: 一定要多提交代码,出现问题时才能更好的溯源
  • 给Vue Router的建议: 建议直接将警告改成报错,并且增加提示

以上就是使用Vue Router路由懒加载引发的生产页面白屏问题的解决方法的详细内容,更多关于Vue Router懒加载引发页面白屏的资料请关注脚本之家其它相关文章!

相关文章

  • vue如何实现对请求参数进行签名

    vue如何实现对请求参数进行签名

    这篇文章主要介绍了vue如何实现对请求参数进行签名问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-01-01
  • Vue组件的实现原理详细分析

    Vue组件的实现原理详细分析

    在日常业务开发中我们会经常封装一些业务组件,下面这篇文章主要给大家介绍了关于Vue组件的实现原理,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2023-01-01
  • Vue数据绑定简析小结

    Vue数据绑定简析小结

    这篇文章主要介绍了Vue数据绑定简析小结,本文将从源码的角度来对Vue响应式数据中的观察者模式进行简析。小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-05-05
  • vue打包部署到springboot并通过tomcat运行的操作方法

    vue打包部署到springboot并通过tomcat运行的操作方法

    这篇文章主要介绍了vue打包部署到springboot并通过tomcat运行的操作方法,本文通过实例图文并茂的形式给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2024-05-05
  • 详解基于vue-cli优化的webpack配置

    详解基于vue-cli优化的webpack配置

    本篇文章主要介绍了详解基于vue-cli优化的webpack配置,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • Vue3侦听器的实现原理详情

    Vue3侦听器的实现原理详情

    这篇文章主要介绍了Vue3侦听器的实现原理详情,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-08-08
  • Vue中的基础过渡动画及实现原理解析

    Vue中的基础过渡动画及实现原理解析

    这篇文章主要介绍了Vue中的基础过渡动画原理解析,需要的朋友可以参考下
    2018-12-12
  • vue表格(table)计算总计方式

    vue表格(table)计算总计方式

    这篇文章主要介绍了vue表格(table)计算总计方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-07-07
  • 在vue中使用Echarts画曲线图的示例

    在vue中使用Echarts画曲线图的示例

    这篇文章主要介绍了在vue中使用Echarts画曲线图的示例,帮助大家在vue中绘制图表,感兴趣的朋友可以了解下
    2020-10-10
  • vue-simple-uploader上传成功之后的response获取代码

    vue-simple-uploader上传成功之后的response获取代码

    这篇文章主要介绍了vue-simple-uploader上传成功之后的response获取代码,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧~
    2020-09-09

最新评论