8.4 部署 Vue 前端与 /api 反向代理

第 62 节 / 共 81 节 课程:前后端穿透

Vue 项目执行 npm run build 后得到 dist 目录,里面是 index.html、js、css、图片。把这些文件放到服务器的一个目录,例如 /data/www/learning,然后让 Nginx 指向它。

Vue Router 使用 history 模式时,刷新 /course/1 这种地址,服务器上并没有对应的文件,会 404。解决方法是 try_files:先找真实文件,再找目录,最后统一回 index.html,把路由交给前端。

server {
    listen 80;
    server_name www.example.com;
    root /data/www/learning;
    index index.html;
 
    location / {
        try_files $uri $uri/ /index.html;
    }
 
    location /api/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
 
    location ~* \.(js|css|png|jpg|jpeg|gif|svg|woff2?)$ {
        expires 7d;
        add_header Cache-Control "public, max-age=604800";
    }
}

前端打包产物带 hash 的文件可以缓存很久;index.html 不能缓存,否则用户会一直拿到旧入口。一般对 html 单独加 no-cache:

location = /index.html {
    add_header Cache-Control "no-cache, no-store, must-revalidate";
}

文件上传失败、报 413,多半是 Nginx 默认只允许 1MB。把 client_max_body_size 调到业务需要的值,例如 20m,并同时检查 Spring Boot 的 multipart 限制。

client_max_body_size 20m;

开启 gzip 能明显减小 js/css 体积。注意不要重复压缩图片和视频,它们本身已经是压缩格式。

gzip on;
gzip_min_length 1k;
gzip_comp_level 6;
gzip_types text/plain text/css application/json application/javascript application/xml;
提示

/api/ 的 proxy_pass 如果写成 http://127.0.0.1:8080/,请求 /api/login 会被改写成 /login;写成不带斜杠的 http://127.0.0.1:8080,后端收到的仍是 /api/login。两种写法要和 Spring Boot 的 context-path、Controller 映射对齐。

《前后端穿透》课程目录

按教材顺序从 Vue 前端讲到 Spring Boot 后端:模板、组件、路由、axios、Controller、JPA、文件上传、Nginx 部署,最后完成学习平台实训。10 章 71 节,配 220 张操作截图与可直接运行的代码。