Java自学者论坛

 找回密码
 立即注册

手机号码,快捷登录

恭喜Java自学者论坛(https://www.javazxz.com)已经为数万Java学习者服务超过8年了!积累会员资料超过10000G+
成为本站VIP会员,下载本站10000G+会员资源,会员资料板块,购买链接:点击进入购买VIP会员

JAVA高级面试进阶训练营视频教程

Java架构师系统进阶VIP课程

分布式高可用全栈开发微服务教程Go语言视频零基础入门到精通Java架构师3期(课件+源码)
Java开发全终端实战租房项目视频教程SpringBoot2.X入门到高级使用教程大数据培训第六期全套视频教程深度学习(CNN RNN GAN)算法原理Java亿级流量电商系统视频教程
互联网架构师视频教程年薪50万Spark2.0从入门到精通年薪50万!人工智能学习路线教程年薪50万大数据入门到精通学习路线年薪50万机器学习入门到精通教程
仿小米商城类app和小程序视频教程深度学习数据分析基础到实战最新黑马javaEE2.1就业课程从 0到JVM实战高手教程MySQL入门到精通教程
查看: 906|回复: 0

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

[复制链接]
  • TA的每日心情
    奋斗
    2024-11-24 15:47
  • 签到天数: 804 天

    [LV.10]以坛为家III

    2053

    主题

    2111

    帖子

    72万

    积分

    管理员

    Rank: 9Rank: 9Rank: 9

    积分
    726782
    发表于 2021-7-4 09:44:48 | 显示全部楼层 |阅读模式

    写在前面

    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-Routervue、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

    哎...今天够累的,签到来了1...
    回复

    使用道具 举报

    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

    QQ|手机版|小黑屋|Java自学者论坛 ( 声明:本站文章及资料整理自互联网,用于Java自学者交流学习使用,对资料版权不负任何法律责任,若有侵权请及时联系客服屏蔽删除 )

    GMT+8, 2024-12-23 05:04 , Processed in 0.064311 second(s), 29 queries .

    Powered by Discuz! X3.4

    Copyright © 2001-2021, Tencent Cloud.

    快速回复 返回顶部 返回列表