解决vue3项目打包发布到服务器后访问页面显示空白问题

 更新时间:2023年03月19日 15:49:22   作者:月影星云  
这篇文章主要介绍了解决vue3项目打包发布到服务器后访问页面显示空白问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

vue3项目打包发布到服务器后访问页面显示空白

1、处理vue.config.js文件中的publicPath

处理如下:

const { defineConfig } = require('@vue/cli-service')
module.exports = defineConfig({
    publicPath: process.env.NODE_ENV === 'production' ? './' : '/',
    outputDir: 'dist',
    indexPath: 'index.html',
    lintOnSave: false,
    transpileDependencies: true,
})

2、处理router文件夹中的index.js文件

处理如下:采用修改后的部分

import { createRouter, createWebHistory, createWebHashHistory  } from 'vue-router';
import routes from "./routes";

const router = createRouter({
    //history: createWebHistory(process.env.BASE_URL),//默认时
    history: createWebHashHistory(process.env.BASE_URL),//修改后
    routes
})
export default router;

解决以上这两步,就解决vue3项目打包发布到服务器后访问页面显示空白问题

在打包项目时显示空白页问题和一些解决思路

在项目开发完毕后我们就会进行打包

npm run build

打包生成的文件会在dist文件夹中

但有时候打开index.html 会出现空白页面

接下来我们从几个方面来进行分析:

一、打包时整体资源路径

根据实际情况要判断    是/   还是 ./ 

在vue-ui 里配置:

在vue.config.js里配置:

module.exports = {
//基本路径 文件打包后放的位置
publicPath:‘./',
 
//默认输出文件夹为dist,填入的名字为打包后的文件名
outputDir:‘name',
 
// 放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录。资源放的目录
assetsDir: “./static”,
 
// 指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径 index的路劲和名字
indexPath: ‘./index.html',
 
//打包后是否生成map文件,map文件能看到错误代码位置,设置为false不生成map文件,打包体积缩小
productionSourceMap: false,
}

二、路由模式

是哈希 还是 历史模式 

推荐 哈希模式 兼容性更高 #以后路径不会发送给服务器 避免一些错误

const router = new VueRouter({
  routes,
  mode:'hash',
})

三、开发和生产环境切换的原因

因为我们开发环境时

npm run serve 模拟的是本地服务器

打包成dist文件夹 导致端口等一些变化 当中的内容请求不过来 所以导致空白页

我们可以简单部署本地服务器让 dist 跑起来

创建文件夹

  • 在文件夹终端 初始化 npm npm init -y
  • 安装 express  npm i express -S
  • 把dist 复制到新文件夹中
  • 创建 app.js 写代码

开启gzip 减小文件体积 使传输速度更快

  • 安装对应包  npm install compression -p
  • 导入包 const compression = require('compression')
  • 启用中间件 app.use(compression())

使用PM2 管理应用

  • 安装 npm i pm2 -g
  • 启动项目:pm2 start .\app.js --自定义名称
  • 查看运行项目 pm2 ls
  • 重启项目 pm2 restart 自定义名称(ID)
  • 停止项目 pm2 stop 自定义名称(ID)
  • 删除项目 pm2 delete 自定义名称(ID)

app.js:

const express = require('express')
const app = express()
 
const compression = require('compression')
 
app.use(compression()) // 一定要把这一行写在 静态资源托管之前
app.use(express.static('./dist'))
 
app.listen(80,()=> {
  console.log('server running at http://127.0.0.1')
})

在这里能跑起来 dist 给后端大哥也不成问题了

四、执行构建之前可以进行一些优化

在 vue.confjg.js 中分别设置 本地服务 和 构建 的入口文件

module.exports = {
  chainWebpack:config=>{
    //发布模式
    config.when(process.env.NODE_ENV === 'production',config=>{
      //entry找到默认的打包入口,调用clear则是删除默认的打包入口
      //add添加新的打包入口
      config.entry('app').clear().add('./src/main-prod.js')
 
      //使用externals设置排除项
      config.set('externals',{
        vue:'Vue',
        axios:'axios',
        lodash:'_',
        echarts:'echarts',
        nprogress:'NProgress',
      })
 
// 在项目的根目录创建一个vue.config.vue文件,添加上 chainWebpack,修改args里的参数配置,重新返回就可以  这里是 判断是开发版本 还是 发布版本
      config.plugin('html').tap(args => {
        args[0].isProd = true
        return args
      })
 
    })
    //开发模式
    config.when(process.env.NODE_ENV === 'development',config=>{
      config.entry('app').clear().add('./src/main-dev.js')
 
      config.plugin('html').tap(args => {
        args[0].isProd = false
        return args
      })
    })
 
  }
}
  • main-dev.js 开发版本总入口
  • main-prod.js 发布版本总入口 在这里根据开发版本改进 删除不需要的依赖项 改用cdn引入、配置路由懒加载的插件......

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 教你在vue 中使用 svg symbols

    教你在vue 中使用 svg symbols

    这篇文章主要介绍了如何在 vue 中使用 svg symbols,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-08-08
  • 解决vue3项目打包发布到服务器后访问页面显示空白问题

    解决vue3项目打包发布到服务器后访问页面显示空白问题

    这篇文章主要介绍了解决vue3项目打包发布到服务器后访问页面显示空白问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03
  • Vue+elementUI实现多图片上传与回显功能(含回显后继续上传或删除)

    Vue+elementUI实现多图片上传与回显功能(含回显后继续上传或删除)

    这篇文章主要介绍了Vue+elementUI实现多图片上传与回显功能(含回显后继续上传或删除),本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-03-03
  • Vue+tracking.js 实现前端人脸检测功能

    Vue+tracking.js 实现前端人脸检测功能

    这篇文章主要介绍了Vue+tracking.js 实现前端人脸检测功能,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • 深度剖析 Vue3 在浏览器的运行原理

    深度剖析 Vue3 在浏览器的运行原理

    这篇文章主要介绍了深度剖析Vue3在浏览器的运行原理,文章通过围绕主题展开相关详细介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-09-09
  • 详解mpvue小程序中怎么引入iconfont字体图标

    详解mpvue小程序中怎么引入iconfont字体图标

    这篇文章主要介绍了详解mpvue小程序中怎么引入iconfont字体图标,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10
  • vue组件开发之slider组件使用详解

    vue组件开发之slider组件使用详解

    这篇文章主要为大家详细介绍了vue组件开发之slider组件的使用方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-08-08
  • Vue如何实现el-table多选样式变为单选效果

    Vue如何实现el-table多选样式变为单选效果

    这篇文章主要介绍了Vue如何实现el-table多选样式变为单选效果,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-05-05
  • Vue项目中如何配置src文件下的@别名

    Vue项目中如何配置src文件下的@别名

    这篇文章主要介绍了Vue项目中如何配置src文件下的@别名问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • vue3+ts使用APlayer的示例代码

    vue3+ts使用APlayer的示例代码

    这篇文章主要介绍了vue3+ts使用APlayer的示例代码,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-08-08

最新评论