Web 服务器与网关 / 系统课时
部署单页应用
部署单页应用
本课解决前端单页应用部署后的路由问题。通过发布构建产物并配置 try_files 回退规则,可以让 Vue、React 等 History 模式应用在刷新任意页面时仍然返回入口文件,同时避免静态资源和后端接口被错误转发。
学习目标
- 理解单页应用静态部署的文件访问模型。
- 掌握 try_files 的页面路由回退配置。
- 能区分前端路由、静态资源和后端接口路径。
准备前端构建产物
单页应用生产构建后通常生成 HTML、JavaScript、CSS 和图片字体等静态文件。部署时只需要将这些文件放入 Nginx 的站点目录,由 Nginx 直接提供访问。
bash
cp -r dist/* /var/www/app/
ls /var/www/app预期输出
text
index.html
assets
favicon.ico配置 History 路由回退
浏览器访问 /user/profile 时,服务器默认会寻找同名文件。如果应用使用前端路由,该路径通常不存在,因此需要通过 try_files 将不存在的路径交给入口文件处理。
nginx
server {
listen <PORT>;
server_name app.example.com;
root /var/www/app;
location / {
try_files $uri $uri/ /index.html;
}
}预期结果
text
访问 /user/profile
如果存在真实文件则返回文件
如果不存在则返回 /index.html,由前端路由接管区分静态资源与后端接口
实际项目中通常同时存在页面路由和 API 请求。静态资源需要由 Nginx 返回,接口请求则应该转发到后端服务,避免所有路径都回退到 index.html。
nginx
location /api/ {
proxy_pass http://backend;
}
location / {
try_files $uri $uri/ /index.html;
}预期结果
text
/api/users 请求进入后端服务
/assets/app.js 直接返回静态文件
/profile 页面路由返回 index.html验证部署效果
部署完成后,需要分别测试入口页面、静态资源和前端路由。出现刷新 404 时,通常检查 try_files 是否存在以及 index.html 是否位于 root 指定目录。
bash
curl -I http://app.example.com/profile预期结果
text
HTTP/1.1 200 OK
Content-Type: text/html按自己的节奏,确认真正理解。