前端项目public目录下的文件,部署到服务器后无法下载

问题回溯

这是一个外包项目,部署在本公司的域名的根路径下是可以下载的,但是部署到客户服务器时,是部署在网站根路径下的二级路由(/web-app)下的,这样就访问不到了

ini 复制代码
<div class="download"> 
    <a href="/static/file/auth.zip" download="授权文件.zip">下载授权资料</a>
</div>

问题分析

webpack是如何处理静态资源的

  1. 如src/assets中的文件通过相对路径被引用,这类引用会被webpack处理
  2. 放在public目录下或者通过绝对路径引用,这类资源会被直接拷贝,不会经过webpack处理

url转换规则

  1. 如果路径是绝对路径,会被原样保留
  2. 如果是相对路径,将会看作模块依赖被webpack处理
  3. 如果以@开头,也会被看作模块依赖,一般@的alias配给了src目录
  4. 如果以~开头,其后的部分将被看作模块依赖,既可以加载含有别名的静态资源,又可以加载node_modules的资源

结论

  1. 参照以上webpack的解析规则分析,这个引用是绝对路径而且在public中,webpack不做处理,webpack中配置的publicPath也自然作用不到这里,所以打包之后的路径仍是/static/file/auth.zip
  2. 当部署在网站的根路径时,点击a标签访问路径是https://xxx.com/static/file/auth.zip,是可以找到资源的
  3. 如果网站部署在网站根路径下/web-app之后,点击a标签访问路径是https://xxx.com/static/file/auth.zip,真实资源路径是https://xxx.com/web-app/static/file/auth.zip

问题解决

将访问路径由https://xxx.com/static/file/auth.zip转换为https://xxx.com/web-app/static/file/auth.zip即可,这里采用环境变量的方式将nginx的路由配置在.env文件中,也可以直接替换成/web-app,但是路由变动之后,改动会很多

xml 复制代码
<div class="download"> 
    <a :href="authPath" download="授权文件.zip">下载授权资料</a> 
</div> 
<script setup> 
import { Warning } from '@element-plus/icons-vue'
const authPath = `${process.env.VUE_APP_PUBLIC_PATH}/static/file/auth.zip` 
</script>

参考

Vue处理静态资源:public、assets目录 - vickylinj - 博客园 (cnblogs.com)

相关推荐
excel4 小时前
ES6 中函数的双重调用方式:fn() 与 fn\...``
前端
可乐爱宅着4 小时前
全栈框架next.js入手指南
前端·next.js
你的人类朋友6 小时前
什么是API签名?
前端·后端·安全
会豪8 小时前
Electron-Vite (一)快速构建桌面应用
前端
中微子8 小时前
React 执行阶段与渲染机制详解(基于 React 18+ 官方文档)
前端
唐某人丶8 小时前
教你如何用 JS 实现 Agent 系统(2)—— 开发 ReAct 版本的“深度搜索”
前端·人工智能·aigc
中微子8 小时前
深入剖析 useState产生的 setState的完整执行流程
前端
遂心_8 小时前
JavaScript 函数参数传递机制:一道经典面试题解析
前端·javascript
小徐_23338 小时前
uni-app vue3 也能使用 Echarts?Wot Starter 是这样做的!
前端·uni-app·echarts
RoyLin8 小时前
TypeScript设计模式:适配器模式
前端·后端·node.js