AIGC标识 每日学习打卡|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 彻底干掉,顺便给站点挂上小绿锁。

posted @ 2026-11-19 20:04  F胡图图  阅读(3)  评论(0)    收藏  举报