vue项目打包上线的一些坑(持续更新中)

一、打包的命令

相信同学们对于打包vue-cli项目都不陌生了,简单的执行下面这条语句就行了:

npm run build

看看我们的 package.json 文件,它的 scripts 里有这么一句

"build": "node build/build.js"

因此,我们可以执行上面的那条命令进行打包,常用的 npm run dev 等等也是同理

本地打包就这样非常轻松的完成了

注意,有几个可能你不知道的坑在等着你!!!



二、Tip: built files are meant to be served over an HTTP server. Opening index.html over file:// won't work.


看到控制台给出了这样的提示,,很多同学慌了:是不是我打包失败了?

别紧脏,控制台告诉我们只能够在http服务器下访问我们的index.html,而不能从本地文件中打开,并没有提示我们打包失败!

想要本地访问我们的项目,只需要在本地启一个测试服务器就好啦,这里推荐一个好用的软件:xampp ,不多介绍,同学们自行查阅安装。

后台同学已经配好了Jenkins自动构建,我们不需要在本地打包,跳过这一步,直接把源码上传到我们的代码仓库(gitlab)中,等待服务器构建完毕,就能访问啦!

具体的配置等服务端同学的帖子发了,我再贴给大家!



二、去除路由中的 #

我们本地环境开发的时候,默认的访问地址:

localhost:8080/#/路由

访问后台同学配置好的域名,看看我们的地址栏:

服务端配置的地址/#/路由

想想百度之类的网站,哪有这个,啥玩意,丑!!

下面我们去掉它

看我们项目目录里 config 文件夹下的 index.js 文件


里面 module.export 的有两个配置:dev 和 build,分别代表开发环境和生产环境,我们看生产环境

// Template for index.html

index: path.resolve(__dirname, '../dist/index.html'), // index.html

// Paths

assetsRoot: path.resolve(__dirname, '../dist'), // 打包输出目录

assetsSubDirectory:'static', // 静态资源目录

assetsPublicPath:'./',

这几句决定了我们的打包路径

首先我们把 assetsPublicPath 改成绝对路径 ‘/’ 

再看 src/router/index.js 这个文件,也就是我们常用的路由配置文件


添加这样一句:

mode:'history',

将路由模式改为history,具体介绍看 官方文档 ,这里不多讲。

网上还有说法,需要在这里添加 base 配置,否则会导致嵌套路由失效,我没加,啥问题也没有,暂时不管。

好了,前端能做的就只有这么多了,剩下的都是服务端同学的工作了

什么,不服气?你只是个前端,就算你技术再好......咳咳,扯远了



三、刷新页面显示404错误

页面刷新后报404错误,原因其实也很简单

vue是个单页应用,它的路由是模拟的url,并没有在服务器上真实存在,当然访问不到

举个栗子🌰

我们的网址是:www.xxx.com,后端同学会把服务器上的 index.html 映射到这个网址上

然而,当我们访问登录页,在地址栏输入 www.xxx.com/login 的时候,服务器蒙了,臣妾做不到啊!哪有这个东西,不得已,只好给个404给你

官网推荐nginx服务器添加如下配置:

location / {

    try_files $uri $uri/ /index.html;

}

意思就是在访问所有请求不到的资源地址的时候,返回我们的index.html

不知道你们成功没有,反正我们这么搞没成功,但据说也差不多,具体的配置以后再发!!!

所以如果有问题,去麻烦你的后端同学吧,纯前端真的只能做到二里面的两步,555......


四、静态资源路径错误

这个问题网上的解决方案有很多,我也试过很多,有的行有的不行,这里简单给个终级解决方案:

图片:就上传到静态服务器上,别管相对路径绝对路径的,这样最稳,我们用的是 阿里云OSS

当然,如果你的页面运行在https而文件路径是http,页面上会有不少警告

js文件:一般都分布在各个组件里,个人习惯把公共js文件放在 /src/common/js/ 目录下,你也可以放在 /src/assets/js/ 目录下

第三方插件的js:一定要放在 static 文件夹里,他和assets的区别,简单来说,就在于:static文件夹不会进行二次打包

然后在index.js里引用这个文件,当然,能用npm安装,尽量还是npm吧

样式文件,请看我的另一篇文章:vue-cli项目如何使用sass?

这样做,上线后的资源路径,基本不会有问题



五、Uncaught SyntaxError: Unexpected token <

最开始,遇到这个问题,我是一脸懵逼的

别晃,冷静,我们看控制台,报错地址是我用的第三方插件

说到底,还是资源路径有问题

出现这个问题,我们的index.html应该是这么写的:

<script src="./static/js文件名"></script>

想想我们第二步最开始做了什么?生产环境下,我们的路径已经修改为绝对路径

那么做相应的修改,把那个点号去掉

<script src="/static/js文件名"></script>

修改成功,看看控制台,不再报错了。



六、结语

本来开发开开心心的心情,怎么一到打包就不行了捏,打包这件事儿,肯定还有许多我也没遇到的坑,所以这篇文章也会不定期更新。

希望这篇文章能够帮助同学们成功爬坑,如果对您有所帮助,请关注、点赞并收藏,有其他问题也可以留言或私信,欢迎讨论!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335