每日学习打卡|2026-11-19:拦截器模块化重构 + Nginx 部署初体验
学习方向:前端工程化(Axios 拦截器拆分)+ 部署上线(Nginx 静态托管与反向代理),今日投入约 4 小时。
1. 今天干了什么
昨天预告的两件事今天都推进了,而且第一次把自己的项目真正跑在了服务器的 80 端口上,感觉挺不一样:
- 拦截器重构:把
axios.interceptors里那一坨逻辑拆成了http/index.js(只负责创建实例、注册拦截器)和http/refreshManager.js(只负责刷新 token 与重放队列)。原来 120 行的拦截器文件现在只剩 30 行左右。 - 配合 Pinia 收尾:给
useAuthStore补了isLoggedIn、displayName两个 getter,组件里那些重复的computed(() => store.token !== '')全部删掉,改用 store 的 getter。 - Nginx 部署:租了台 2 核 4G 的云服务器(CentOS 7),
yum install nginx装好,npm run build打包上传dist,配好server块,前端静态托管 +/api反代到本机 8080 的 Spring Boot。 - Java 端配套:
application-prod.yml用 Profile 分离配置,把数据库密码、Redis 地址挪到环境变量,加了/actuator/health方便探活。
重构后的刷新模块,核心是一个「队列 + 单飞」的独立对象,不再依赖全局变量:
// http/refreshManager.js
let refreshing = false;
let queue = [];
export function createRefreshManager({ http, getRefreshToken, onSuccess, onFail }) {
return async function refreshAndReplay(config) {
if (refreshing) {
return new Promise((resolve) => queue.push(() => resolve(http(config))));
}
refreshing = true;
try {
const { data } = await http.post('/auth/refresh', { refreshToken: getRefreshToken() });
onSuccess(data.accessToken);
queue.forEach((cb) => cb());
queue = [];
config.headers.Authorization = `Bearer ${data.accessToken}`;
return http(config);
} catch (e) {
queue = [];
onFail();
throw e;
} finally {
refreshing = false;
}
};
}
拦截器那边就清爽了,只做一件事——判断要不要交给刷新模块:
// http/index.js
const refreshAndReplay = createRefreshManager({ http, getRefreshToken, onSuccess, onFail });
http.interceptors.response.use(null, (error) => {
const { response, config } = error;
if (response?.status !== 401 || config._retried || config.url.includes('/auth/refresh')) {
return Promise.reject(error);
}
config._retried = true;
return refreshAndReplay(config);
});
Nginx 配置不长,但每一行都是踩过坑之后留下的:
server {
listen 80;
server_name hu-tu-tu.example.com;
root /usr/share/nginx/html/hututu;
index index.html;
# history 路由:找不到文件就交回给 index.html
location / {
try_files $uri $uri/ /index.html;
}
# 静态资源长缓存
location ~* \.(js|css|png|jpg|svg|woff2)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location /api/ {
proxy_pass http://127.0.0.1:8080/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
gzip on;
gzip_min_length 1k;
gzip_types text/css application/javascript application/json image/svg+xml;
}
2. 明天要干什么
- 数据库:终于要动慢查询了。拿
EXPLAIN把剩下两张表的执行计划打出来,按「等值列在前、范围列在后」的原则设计联合索引,验证上次遗留的Using filesort能不能消掉。 - HTTPS:用 certbot 申请免费证书,把 80 端口改成 301 跳 443,顺便检查混合内容(前端写死的
http://接口地址要清掉)。 - 构建优化:
vite build出来的单个 chunk 有 780KB,试试manualChunks把 vue、element-plus、echarts 拆开,配上路由懒加载看首屏能降多少。 - 部署脚本化:把「打包 → scp 上传 → nginx -s reload」写成一个
deploy.sh,避免每次手动敲。
3. 我遇到的问题和改进方法
问题一:dist 传上去以后,首页能开,一刷新子路由就 404。
- 现象:直接访问
/dashboard正常,按 F5 就变成 Nginx 的 404 页面。 - 原因:Vue Router 用的是 history 模式,
/dashboard在服务器上并不存在对应文件,Nginx 找不到资源就返回 404。 - 改进方法:加
try_files $uri $uri/ /index.html;,让所有找不到的路径回落到入口文件,由前端路由接管。教训:history 模式上线必须配 fallback,本地 dev server 帮你做了这件事,容易忘。
问题二:接口全部 401,后端日志里看不到请求。
- 现象:前端请求
https://域名/api/user/info返回 401,Spring Boot 的 access log 里连这条路径都没有。 - 原因:
proxy_pass写成了http://127.0.0.1:8080(没带结尾斜杠),/api/前缀被原样透传给后端,而后端的@RequestMapping是没有/api前缀的,直接 404;前端把这个 404 当成鉴权失败处理了。 - 改进方法:写成
proxy_pass http://127.0.0.1:8080/api/;,让前缀被正确剥离。另外把后端生产环境的 CORS 配置整个去掉了——同源部署之后不需要它,之前 Nginx 和后端同时加Access-Control-Allow-Origin还导致了响应头重复。
问题三:拆分模块后出现了循环依赖,页面白屏。
- 现象:
index.js引refreshManager,refreshManager又import http from './index',控制台报Cannot access 'http' before initialization。 - 原因:ESM 循环引用时,被引用的模块还没执行完就拿值,拿到的是未初始化的绑定。
- 改进方法:改成依赖注入——
refreshManager只导出工厂函数,http实例由调用方传进来,模块之间不再互相 import。教训:工具模块不要自己去拿全局实例,让调用方给,既解了循环,也方便单测时 mock。
问题四:gzip 开了但体积没变。
- 现象:
Content-Encoding里看不到 gzip,JS 还是原大小传输。 - 原因:Nginx 默认
gzip_types只有text/html,JS/CSS 不在名单里。 - 改进方法:显式补上
gzip_types,并用curl -H 'Accept-Encoding: gzip' -I验证响应头。顺手把gzip_min_length设成 1k,避免小文件压缩反而更大。
明日打卡预告
明天主题:慢查询索引实战 + HTTPS 上线,希望能把 Using filesort 彻底干掉,顺便给站点挂上小绿锁。

浙公网安备 33010602011771号