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

问题回溯

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

<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，但是路由变动之后，改动会很多

<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)