Vue3项目打包并部署到Nginx实践
作者：白滚水_
本文介绍了如何安装Nginx并部署Vue项目,首先从官网下载Nginx并启动服务,然后使用Vite构建Vue项目,将构建好的dist文件夹部署到Nginx目录下,并修改nginx.conf文件以防止刷新页面时出现404错误,最后,总结了刷新页面空白问题的解决方法
一、安装Nginx
官网下载链接：https://nginx.org/en/download.html
下载后解压并双击 nginx.exe 启动服务：
打开浏览器，访问 http://localhost/ ，若出现如下页面，表示安装成功：
若想停止服务，命令行运行：
nginx.exe -s stop
二、打包并部署vue项目
1、vite.config.js/vite.config.ts添加build属性
build: {
sourcemap: false, // 不生成 source map
terserOptions: {
compress: { // 打包时清除 console 和 debug 相关代码
drop_console: true,
drop_debugger: true,
},
},
},
2、终端执行 npm run build
build 完成后会生成一个 dist 文件夹。
3、部署到Nginx
将 dist 文件夹移动到 Nginx 目录下，可以重命名为自己想要的名字，此处重命名为 vue-test：
接下来需要修改一下 conf 目录下 nginx.conf 文件的配置。
自定义设置ip和端口：
listen 5173;
server_name localhost;设置要启动的服务为 vue-test ，同时为了防止刷新页面时报错404，新增 try_files $uri $uri/ /index.html; 这条配置：
location / {
root vue-test;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}另外再加上下面这条配置，同样是为了防止刷新页面时出现404找不到页面：
location @router {
rewrite ^.*$ /index.html last;
}修改完成后整个 nginx.conf 文件的内容如下：
#user nobody;
worker_processes 1;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#pid logs/nginx.pid;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
server {
listen 5173;
server_name localhost;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root vue-test;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
location @router {
rewrite ^.*$ /index.html last;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
#location ~ \.php$ {
# root html;
# fastcgi_pass 127.0.0.1:9000;
# fastcgi_index index.php;
# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
# include fastcgi_params;
#}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
# another virtual host using mix of IP-, name-, and port-based configuration
#
#server {
# listen 8000;
# listen somename:8080;
# server_name somename alias another.alias;
# location / {
# root html;
# index index.html index.htm;
# }
#}
# HTTPS server
#
#server {
# listen 443 ssl;
# server_name localhost;
# ssl_certificate cert.pem;
# ssl_certificate_key cert.key;
# ssl_session_cache shared:SSL:1m;
# ssl_session_timeout 5m;
# ssl_ciphers HIGH:!aNULL:!MD5;
# ssl_prefer_server_ciphers on;
# location / {
# root html;
# index index.html index.htm;
# }
#}
}
完成上述所有配置后，启动Nginx，浏览器访问刚刚自定义的ip+端口，按道理就能够正常进入前端页面了。
三、刷新页面空白问题
如果按照上面过程打包部署到Nginx后，刷新页面后页面就变成空白，可尝试如下修改：
vite.config.js:
// 防止打包后点击刷新后页面空白 publicPath: process.env.NODE_ENV === 'production' ? './' : '/',
router.js:
history: createWebHashHistory(process.env.BASE_URL),
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。