前端项目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)

相关推荐
掘金安东尼27 分钟前
字节前端三面复盘:基础不花哨,代码要扎实(含高频题解)
前端·面试·github
吃奥特曼的饼干34 分钟前
React useEffect 清理函数:别让依赖数组坑了你!
前端·react.js
烛阴42 分钟前
TypeScript 函数重载入门:让你的函数签名更精确
前端·javascript·typescript
前端老鹰43 分钟前
HTML <meta name="color-scheme">:自动适配系统深色 / 浅色模式
前端·css·html
Keya1 小时前
MacOS端口被占用的解决方法
前端·后端·设计模式
moyu841 小时前
解密Vue组件中的`proxy`:此Proxy非彼Proxy
前端
用户84913717547161 小时前
为什么大模型都离不开SSE?带你搞懂第1章〈SSE技术基础与原理〉
前端·网络协议·llm
随笔记1 小时前
react中函数式组件和类组件有什么区别?新建的react项目用函数式组件还是类组件?
前端·react.js·typescript
在星空下1 小时前
Fastapi-Vue3-Admin
前端·python·fastapi
FogLetter1 小时前
面试官问我Function Call,我这样回答拿到了Offer!
前端·面试·openai