必须同时对齐publicPath、router.base和Nginx的alias路径；publicPath和base须严格为'/admin/'（首尾斜杠不可缺），Nginx用location /admin/ { alias /opt/dist/; try_files $uri $uri/ /admin/index.html; }。
必须同时对齐 publicPath、router.base 和 Nginx 的 alias 路径，缺一不可；只改其中一个，资源 404 或刷新白屏是必然结果。
Vue CLI / Vite 构建时 publicPath 必须带尾部斜杠
构建产物中 JS/CSS 的引用路径由 publicPath 决定。写成 '/admin'（缺末尾斜杠）会导致浏览器请求 /adminjs/app.abc.js —— 拼接错误，直接 404。
-
vue.config.js中设为：publicPath: '/admin/'（前后都带斜杠） - Vite 项目在
vite.config.ts中配置：base: '/admin/' - 不能用
'./'或''，否则刷新时相对路径失效，静态资源加载失败
Vue Router 的 base 值必须与 publicPath 完全一致
前端路由基地址不匹配，会导致页面跳转正常，但刷新时 Vue Router 无法识别当前 URL，返回空白或错误路由。
- 初始化 router 时写死：
base: '/admin/'，和publicPath字符串完全相同 - 不要动态拼接，比如
base: process.env.BASE_URL，除非环境变量值也严格等于'/admin/' - React Router 的
basename同理，必须和构建homepage配置一致
Nginx 必须用 alias + 精准 location 匹配子路径
用 root 会把 /admin/ 拼进路径，导致实际查找 /opt/dist/admin/js/app.js；而文件真实位置是 /opt/dist/js/app.js。只有 alias 能做“整段替换”。
- location 块必须精确匹配路径前缀：
location /admin/ { ... }（结尾斜杠不能少） -
alias后路径也必须以/结尾：alias /opt/dist/; -
try_files的 fallback 要写成/admin/index.html，因为浏览器请求的是这个 URL，Nginx 内部才去读/opt/dist/index.html
验证三者是否真正对齐的实操检查法
打开浏览器开发者工具 Network 面板，直接看资源请求：
- 访问
https://example.com/admin/，应返回index.html（状态码 200） - 查看 JS 请求，URL 应为
https://example.com/admin/js/app.xxx.js，响应内容是 JS 代码（不是 HTML） - 手动请求
https://example.com/admin/js/app.xxx.js和https://example.com/admin/404-test，前者 200，后者也 200 且返回index.html，说明 fallback 生效
最容易被忽略的是：Nginx 的 alias 和前端 publicPath 之间没有自动同步机制，改了任一端却忘了另一端，问题立刻复现。
