Vuejs+vue-router打包+Nginx配置

最新推荐文章于 2025-10-13 15:47:38 发布

原创最新推荐文章于 2025-10-13 15:47:38 发布 · 9.7k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#vue

web-js 专栏收录该内容

2 篇文章

订阅专栏

本文作者通过亲身经历，详细介绍了使用Vue CLI创建的项目，结合vue-router的history模式进行打包，并在Nginx服务器上配置的过程。文中指出，许多教程推荐修改`publicPath`为`./`，但在实际操作中可能导致刷新页面时资源请求错误。作者强调，正确配置Nginx是解决该问题的关键，无需修改webpack的`publicPath`设置，以确保项目正常运行。

其实这个网上已经有了很多人写了，为什么我还要再写这一篇博客？因为我亲身把他们生产的坑给踩了个通透（摊手。

正文开始

本次的项目是基于vue-cli生成的项目，采用的vue-router的history模式。到这里相信大部人还是类似了，接下来就是一个坑死人不偿命的网上诸多博客都在采用的巨坑。
在进行打包的时候，很多博客里都写了，将/config/index.js下，build中的assetsPublicPath从/改为./。我很后悔，为什么当初这样照做的时候不去思考为什么，为什么要这样做，凭什么？如果这个有问题为什么webpack生成的时候不改反而一直放在那里？是谁傻？问题先放在这里，我们先按照那些教程走。修改完后npm run build，这样在你的项目下就生成了一个dist文件夹，里面就是生成的静态内容。假设现在你的dist文件夹已经在你的云服务器中了。接下来开始nginx的配置。
个人采用的是sudo apt-get install nginx安装的nginx，现在在命令行下，
cd /etc/nginx/conf.d/, 并在该目录下 sudo touch vueSite.conf，接下来修改该文件内容。

server {
  listen 3000;  # 假设你项目监听的是3000端口
  root /path/to/dist;
  location / {
      try_files $uri $uri/ /index.html;
  }
}

然后
sudo nginx -t检查正确性，无误后sudo nginx -s reload。
接下来在你的浏览器下访问cloudserverhost:3000，就可以访问到你的项目主页了。
目前来看似乎是一切顺利呢，网上的教程真棒棒哦~
然后你可以试试，在cloudserverhost:3000/path/subpath下刷新试试，你会发现，页面没有了，浏览器器里会报错，你会发现请求的js/css等都变成了html页面的内容。这个问题就是出在了./下，我不知道第一个这样写出来的人他的项目是不是很幸运的只有一级路径，又或者他从来不会尝试去刷新页面，否则这个问题是无可避免的，为什么呢？./是相对路径，/则是绝对路径，当你在二级路径下刷新重新请求资源，你的请求路径是什么？把请求路径写出来我们就会发现问题出在哪里了。很难过，我写这篇博客只用不到10分钟，找到这个问题却用了差不多10小时，查了各种方法，我真是万万没想到。
因此，正式上线的项目，没有必要修改/config/index.js下，build中的assetsPublicPath。配置好nginx，你的项目就可以开始起飞了