Vue项目部署遇到的问题及解决方案

写在前面

Vue-Router 有两种模式,默认是 hash 模式,另外一种是 history 模式。

  • hash:也就是地址栏里的 # 符号。比如 http://www.example/#/hello,hash 的值为 #/hello。特点:hash 虽然出现 URL 中,但不会被包含在 HTTP 请求中,对后端不会产生什么影响,改变 URL 不会重载页面。
  • history:利用了 HTML5 History Interface 中新增的 pushState()replaceState() 方法,来完成 URL 跳转而无须重新加载页面。(需要特定浏览器支持)

hash 和 history 两种模式都是基于浏览器自身的属性,vue-router 只是利用了这两个特性(底层还是浏览器提供的接口)来实现前端路由。

使用场景

一般来说,两种模式都是可以的。除非在意不太漂亮的 #,只能选择 history。

这两种模式在开发环境下都没有什么太大的问题,但是当部署到生产环境中后,两者有所不同。

hash 模式部署没有什么问题,只要访问到服务器上的 index.html,就可以访问网站了。
history 模式下,前端的 URL 必须和实际向后端发起请求的 URL 一致,如 http://www.example.com/user/id。如果后端缺少对 /user/id 的路由处理,将返回 404 错误。

不过这种模式要玩好,还需要后台配置支持……所以呢,你要在服务端增加一个覆盖所有情况的候选资源:如果 URL 匹配不到任何静态资源,则应该返回同一个 index.html 页面,这个页面就是你 app 依赖的页面。- Vue-Router
vue、react等单页面项目应该这样子部署到服务器

问题起因

在做「年度账单」项目的时候,项目部署的时候,用的是 hash 模式。APP安卓端分享出去的链接对于 # 做了特殊处理,encode 转义成了 %23,所以路由只能换成 history 的模式。

因此,现把解决的思路总结下,虽然 官网 上给出了解决方案,但在实际的编码中也遇到了一些问题。

根目录下

当项目在根目录下部署的时候(如 http://www.example.com/),vue 的相关文件默认不需要修改,修改的是后端,这里以 nginx 为例。

location / { try_files $uri $uri/ /index.html; }

$uri 就是访问的 url,不包含 域名querystring。例如 /test/hello 当访问 $uri 时,如果存在,则访问 $uri/, 不存在就访问 /index.html 这样配置好,访问 http://example.com/ 时就可以访问到网站了,进入多级目录后刷新页面也不会存在问题。

子级目录下

这里涉及到修改 vue 项目几个配置文件。
先定义几个环境

  • 部署的域名:http://www.example.com:8080/
  • nginx 的 root 目录:home/web/
  • vue 的部署路径:home/web/h5-year-bill/
  • vue 项目的链接:http://www.example/h5-year-bill/
  • vue 项目的静态资源路径:http://www.example/h5-year-bill/static/

1. 打包后的静态资源路径需要修改

找到 build/config/index.js,代码如下:


...
build: {
...
-    assetsPublicPath
     // 访问路径,修改成绝对路径
+    assetsPublicPath: '/h5-year-bill/'
}

2. 路由文件
Vue-Router 有一个 base 属性, 传送门


base
类型: string
默认值: "/"
应用的基路径。例如,如果整个单页应用服务在 /app/ 下,然后 base 就应该设为 "/app/"

因此,找到 src/router/index.js,代码如下:


// 不影响本地开发,兼容性做了处理
const isHistoryMode = process.env.NODE_ENV === 'production' ? {
  mode: 'history',
  base: '/h5-year-bill/'
} : {
  mode: 'hash'
};

const router = new Router({
  ...isHistoryMode,
  routes
});

至此,打包配置的相关修改已全部完成,项目也能够正常访问。

但还是会有一个问题,跳转到某个路由后,刷新页面,就会出现页面空白,或者路由不通,此时就要修改 nginx 的配置了。

3. nginx 配置相关修改

nginx部署路径/conf/nginx.conf,修改如下:


#h5-year-bill
location ^~ /h5-year-bill {
    root   /home/web;
    index  index.html;
    try_files $uri $uri/ /h5-year-bill/index.html last;
}

/h5-year-bill/ 就是部署的网站目录。

这样几项配置后,就可以在子目录下访问网站,刷新也没有问题。

来源:https://segmentfault.com/a/1190000017844405

原文地址:https://www.cnblogs.com/lalalagq/p/10254642.html

时间: 2024-08-02 00:53:21

Vue项目部署遇到的问题及解决方案的相关文章

Vue 项目部署到GitHub Pages并同步到Gitee Pages

前言:相信很多前端开发者都拥有自己的vue项目,若想把自己的项目做成网站分享给大家看,最常用的就是利用Github提供的GitHub Pages服务和Gitee提供的Gitee Pages服务.其中,Github是国外网站,Gitee是国内网站(访问速度较快).本文给大家介绍的是如何将 vue-cli 3.0+项目部署到github pages 并同步到 gitee Pages上. 一.服务说明与注意事项 在你的github项目设置的GitHub Pages项,有这么一句话: GitHub Pa

nodejs+express搭建服务器及vue项目部署打包

一.Express 1.Node.js 详情及安装https://www.cnblogs.com/LiuFqiang/p/11991468.html 2.Express Express是一个保持最小规模的灵活的Node.js web应用程序开发框架,为web和移动应用程序提供一组强大的功能 安装: npm install express --save -g 3.express-generator 是express项目的生成器,此工具的作用是生成express项目 安装 npm install e

vue项目部署上线

前言 今天把自己写的demo登录写完了,就想着试着走一下部署上线的流程.参考了很多的文档,终于成功进行了部署.在这里将服务器的搭建和vue项目的 部署上线进行整理(都是基础的知识,希望对大家有帮助.对我帮助是很大的) 2.流程 1.服务器搭建 这里我用的是腾讯云的服务器.买了一个域名.没有备案的域名也可以使用.买完服务器进行域名解析. 点击添加解析,按照下面这样填写就行 马赛克是你的外网ip 可以根据你需要的进行修改,我这只是最基本的绑定.其他请自行百度. 3.添加ssh密钥 第一步添加密钥,会

windows下载的java项目部署到linux的各种解决方案

1.Java是跨平台的,在linux下有问题,主要一是文件读取权限:二检查下系统环境变量设置可正确!.profile JavaWeb_将Windows平台上开发的JavaWeb项目部署到Linux平台上 步骤: 1.在Windows平台上,通过MyEclipse的[File] -> [Export] -> 将项目打包成.war文件: 2.在Windows平台上,删除.war文件中与Linux平台上重复或冲突的.jar文件,一般会在项目的notes文件中说明: 3.通过浏览器访问Linux平台的

vue项目部署nginx,配置

#user nobody; worker_processes 1; #error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info; #pid logs/nginx.pid; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream;

【转】】Vue项目部署tomcat,刷新报错404解决办法

转自[https://blog.csdn.net/g631521612/article/details/82835518] 解决方式: - 在tocmat的webapps下的项目中创建WEB-INF文件夹,在文件夹中创建文件web.xml.格式如下: - web.xml内容如下: <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/

vue项目部署到服务器

1.配置config目录下index.js index: path.resolve(__dirname, '../dist/index.html'), assetsRoot: path.resolve(__dirname, '../dist'), assetsSubDirectory: 'static', assetsPublicPath: './', proxyTable: {}, 红色部分是添加,绿色部分是修改 2.使用下面命令开始构建 npm run build 3.构建成功后项目根目录下

linux 服务器 php vue项目部署流程总结

服务器配置 购买阿里云服务器 (选择ubuntu 16系统 / 内存2G以上) 安全策略, 入规则: 添加端口 20,21,22, 80, 443, 3306, 8080, 安装宝塔 wget -O install.sh http://download.bt.cn/install/install-ubuntu.sh && sudo bash install.sh 登录宝塔 安装软件 并 修改宝塔端口号. 用宝塔管理网站配置 添加域名 上传程序 虚拟机目录指向程序public目录 设置伪静态

myeclipse无法将maven项目部署到tomcat的解决方案

如果myeclipse中项目没有报错且显示已部署成功,甚至运行时命令行也没出错 此时到tomcat目录中没有找到当前项目就只有一种可能: 那就是因为某种原因myeclipse认为的项目名不是你认为的项目名,然后把你项目的内容冒名顶替到某一个部署在tomcat的项目中 解决方案: 1.首先查看pom中指定的项目名称是否正确(如果出现了其他项目名就改回来并重新运行) 2.到workspace(直接从myeclipse中找不到)中找到当前项目的文件.mymetadata和.settings/org.e