Vue 项目部署遇到的那些坑

简介: Vue 项目部署遇到的那些坑

1. 页面URL中 号处理

使用 vue-cli 生成的项目模板,运行时在url地址栏多一个#号,服务器部署后会出现 www.example.com/#/ 的情况

image.png


解决方案:

修改 src/router/index.js 文件,修改 vue-router 模式为 history ,设置 bash url效果正常了

image.png

vue-router 官网:router.vuejs.org/zh-cn/essen…

2. 服务器部署 vue 子模块项目

有一个项目地址为 www.example.com ,这个项目下又添加了一个子模块,子模块是单独的一个项目,域名效果变成 www.example.com/sk 的形式访问子模块项目的首页,通过 www.example.com/sk/home 的方式访问子模块项目路由页面

解决方案:

第一步:修改 src/router/index.js 文件中 router 的 bash 配置,效果如下

Vue.use(Router)
export default new Router({
  mode: 'history',
  base: '/sk',
  routes: [
    {
      path: '/',
      name: 'home',
      component: home
    }
  ]
})

第二步:修改 npm run build 命令打包生成的目录结构。打开前端项目根目录下 /config/index.js 文件,打包的默认路径为生成 dist 静态文件目录,默认路径配置如下


...
  build: {
    index: path.resolve(__dirname, '../dist/index.html'),
    assetsRoot: path.resolve(__dirname, '../dist'),
    assetsSubDirectory: 'static',
    assetsPublicPath: '/',
...

修改打包路径配置,静态文件目录下添加一个 sk 子目录,其他打包文件放到 sk 目录下,注意目录中的 / , 前端项目中的配置完成了

...
  build: {
    index: path.resolve(__dirname, '../dist/sk/index.html'),
    assetsRoot: path.resolve(__dirname, '../dist/sk'),
    assetsSubDirectory: 'static',
    assetsPublicPath: '/sk/',
...

第三步:修改 dev 属性下的 assetsPublicPath 路径配置,由原来的 / 修改为 /sk/

...
  dev: {
    // Paths
    assetsSubDirectory: 'static',
    assetsPublicPath: '/sk/',
    proxyTable: {},
    // Various Dev Server settings
    host: 'localhost', // can be overwritten by process.env.HOST
    port: 8080, // can be overwritten by process.env.PORT, if port is in use, a free one will be determined
    autoOpenBrowser: false,
...

第四步:修改服务器 nginx 的配置,设置 sk 路径访问内容,配置如下

...
server {
        listen 80;
        server_name example.com;
        location /  {
            try_files $uri  /index.html;
          root /xxx/projects/example/frontend/dist;
        }
        location /sk  {
            try_files $uri  /sk/index.html;
            alias   /xxx/projects/example-sk/frontend/dist/sk;
        }
    }
...

3. 本地npm run dev正常,服务端运行出错, 出现 www.xxx.com/xx 域名地址下页面空白,控制台出错,资源文件看似正常的情况,如下效果


image.png

config/index.js 配置文件如下

'use strict'
// Template version: 1.1.3
// see http://vuejs-templates.github.io/webpack for documentation.
const path = require('path')
const env = '"' + process.env.NODE_ENV + '"'
console.log(process.env.NODE_ENV)
module.exports = {
  build: {
    env: env,
    index: path.resolve(__dirname, '../dist/admin/index.html'),
    assetsRoot: path.resolve(__dirname, '../dist/admin'),
    assetsSubDirectory: 'static',
    assetsPublicPath: '/admin/',
    productionSourceMap: true,
    // Gzip off by default as many popular static hosts such as
    // Surge or Netlify already gzip all static assets for you.
    // Before setting to `true`, make sure to:
    // npm install --save-dev compression-webpack-plugin
    productionGzip: false,
    productionGzipExtensions: ['js', 'css'],
    // Run the build command with an extra argument to
    // View the bundle analyzer report after build finishes:
    // `npm run build --report`
    // Set to `true` or `false` to always turn it on or off
    bundleAnalyzerReport: process.env.npm_config_report
  },
  dev: {
    env: require('./dev.env'),
    port: process.env.PORT || 8081,
    autoOpenBrowser: true,
    assetsSubDirectory: 'static',
    assetsPublicPath: '/',
    proxyTable: {},
    // CSS Sourcemaps off by default because relative paths are "buggy"
    // with this option, according to the CSS-Loader README
    // (https://github.com/webpack/css-loader#sourcemaps)
    // In our experience, they generally work as expected,
    // just be aware of this issue when enabling this option.
    cssSourceMap: false
  }
}

dev 属性下的 assetsPublicPath: '/', 属性问题,根据实际情况调整,这里调整为 assetsPublicPath: '/admin',, 重新发布部署项目即可

VueCli 3.0 + 以后配置在 vue.config.js 中修改

$ vue --version
3.11.0


vue.config.js 配置如下

module.exports = {
  outputDir: 'dist/admin/'
}


目录
相关文章
|
19天前
|
缓存 JavaScript 前端开发
vue学习第四章
欢迎来到我的博客!我是瑞雨溪,一名热爱JavaScript与Vue的大一学生。本文介绍了Vue中计算属性的基本与复杂使用、setter/getter、与methods的对比及与侦听器的总结。如果你觉得有用,请关注我,将持续更新更多优质内容!🎉🎉🎉
34 1
vue学习第四章
|
19天前
|
JavaScript 前端开发
vue学习第九章(v-model)
欢迎来到我的博客,我是瑞雨溪,一名热爱JavaScript与Vue的大一学生,自学前端2年半,正向全栈进发。此篇介绍v-model在不同表单元素中的应用及修饰符的使用,希望能对你有所帮助。关注我,持续更新中!🎉🎉🎉
28 1
vue学习第九章(v-model)
|
19天前
|
JavaScript 前端开发 开发者
vue学习第十章(组件开发)
欢迎来到瑞雨溪的博客,一名热爱JavaScript与Vue的大一学生。本文深入讲解Vue组件的基本使用、全局与局部组件、父子组件通信及数据传递等内容,适合前端开发者学习参考。持续更新中,期待您的关注!🎉🎉🎉
33 1
vue学习第十章(组件开发)
|
25天前
|
JavaScript 前端开发
如何在 Vue 项目中配置 Tree Shaking?
通过以上针对 Webpack 或 Rollup 的配置方法,就可以在 Vue 项目中有效地启用 Tree Shaking,从而优化项目的打包体积,提高项目的性能和加载速度。在实际配置过程中,需要根据项目的具体情况和需求,对配置进行适当的调整和优化。
|
25天前
|
存储 缓存 JavaScript
在 Vue 中使用 computed 和 watch 时,性能问题探讨
本文探讨了在 Vue.js 中使用 computed 计算属性和 watch 监听器时可能遇到的性能问题,并提供了优化建议,帮助开发者提高应用性能。
|
25天前
|
存储 缓存 JavaScript
如何在大型 Vue 应用中有效地管理计算属性和侦听器
在大型 Vue 应用中,合理管理计算属性和侦听器是优化性能和维护性的关键。本文介绍了如何通过模块化、状态管理和避免冗余计算等方法,有效提升应用的响应性和可维护性。
|
25天前
|
存储 缓存 JavaScript
Vue 中 computed 和 watch 的差异
Vue 中的 `computed` 和 `watch` 都用于处理数据变化,但使用场景不同。`computed` 用于计算属性,依赖于其他数据自动更新;`watch` 用于监听数据变化,执行异步或复杂操作。
|
25天前
|
JavaScript 前端开发 UED
vue学习第二章
欢迎来到我的博客!我是一名自学了2年半前端的大一学生,熟悉JavaScript与Vue,目前正在向全栈方向发展。如果你从我的博客中有所收获,欢迎关注我,我将持续更新更多优质文章。你的支持是我最大的动力!🎉🎉🎉
38 3
|
26天前
|
存储 JavaScript 开发者
Vue 组件间通信的最佳实践
本文总结了 Vue.js 中组件间通信的多种方法,包括 props、事件、Vuex 状态管理等,帮助开发者选择最适合项目需求的通信方式,提高开发效率和代码可维护性。
|
25天前
|
JavaScript 前端开发 开发者
vue学习第一章
欢迎来到我的博客!我是瑞雨溪,一名热爱JavaScript和Vue的大一学生。自学前端2年半,熟悉JavaScript与Vue,正向全栈方向发展。博客内容涵盖Vue基础、列表展示及计数器案例等,希望能对你有所帮助。关注我,持续更新中!🎉🎉🎉
50 2