前端和运维的哪些爱

完成内容

  • 完成 4-5 个接口的前端联调工作
  • 接入并测试微信支付流程
  • 协助运维排查接口 404 的部署问题

Nginx 404 排查经历

问题现象

前端部署后,所有接口统一返回 404 Not Found 。

后端确认服务已正常启动,因此开始排查前端与 Nginx 配置。


排查过程

1. 检查前端请求前缀(baseUrl)

前端配置的请求前缀为:

复制代码
/api

Nginx 中转发规则:

复制代码
location /api/ {
    proxy_pass http://backend/;
}

两边一致,但访问依然报 404。

2. 检查后端路径

Controller 映射路径正常,但后台日志显示:请求未到达后端 。

这说明问题还是出在 Nginx 转发链路。

3. 验证实际可访问路径

让运维提供后端真实可访问地址后发现:

后端部署时多加了一个服务前缀,例如:

复制代码
/server-prefix

实际路径变成:

复制代码
/server-prefix/user/info

但前端与 Nginx 都没有拼接这个前缀,因此全部 404。


最终解决方案

  • 前端修改配置文件中的 baseUrl重新打包:

    /server-prefix

  • 更新 Nginx:

    location /server-prefix {
    proxy_pass http://backend;
    }

修改后重新部署 → 全部接口恢复正常。


🎉 今日总结

  • 完成接口联调与支付流程接入
  • 协助定位 Nginx 转发与后端路径不一致的问题
  • 问题根本原因:后端部署新增路径前缀但未同步告知

整体工作顺利,排查过程也帮助团队更好梳理了路径配置规则。

Nginx 转发关键知识总结

## 1. Nginx 路径匹配规则

1.1 精确匹配 (=)

nginx 复制代码
location = /api {
}

只匹配完全等于 /api 的请求。


1.2 普通前缀匹配

nginx 复制代码
location /api {
}

匹配所有以 /api 开头的请求。


1.3 最常用:/api/ 前缀匹配

nginx 复制代码
location /api/ {
}
  • 匹配所有以 /api/ 开头的路径
  • 匹配到的部分 /api/ 会被处理用于后续的转发逻辑

适用于大多数前后端分离项目的 API 转发。


1.4 正则匹配(~ / ~*)

nginx 复制代码
location ~ \.php$ {
}

用于正则判断,不常用于 API 场景。


## 2. proxy_pass 加斜杠 vs 不加斜杠 的区别(重点!)

假设如下配置:

nginx 复制代码
location /api/ {
    proxy_pass http://backend/;
}

2.1 proxy_pass 结尾带 /(常用于 API)

  • 会 删除 location 中匹配到的部分 (如 /api/)
  • 然后把剩余路径拼到 proxy_pass 后

示例:

请求:

复制代码
/api/user/info

后端收到:

复制代码
/user/info

这是接口转发最常用、最安全的写法。


2.2 proxy_pass 结尾不带 /

  • 不会删除匹配到的部分
  • 请求路径整体追加到 proxy_pass 后

示例:

nginx 复制代码
location /api/ {
    proxy_pass http://backend;
}

请求:

复制代码
/api/user/info

后端收到:

复制代码
/api/user/info

最关键总结表

location proxy_pass 后端最终收到路径
/api/ http://backend/ /user/info
/api/ http://backend /api/user/info

区别就在于 proxy_pass 后面有没有 /。


## 3. 什么时候应该加 /?

推荐规则:

需求 写法 原因
去掉 /api 前缀(最常用) proxy_pass http://backend/; 自动移除匹配前缀,路径更干净
保留 /api 前缀 proxy_pass http://backend; 原样转发完整路径

## 4. 为什么会出现转发后 404?(与你的场景对应)

问题原因:

  • 前端访问:/api/user/info
  • Nginx 去掉 /api/ → 转发 /user/info
  • 但后端真实路径是:/server-prefix/user/info

路径不一致 → 404

最终通过:

  • 前端 baseUrl 增加 /server-prefix
  • Nginx proxy_pass 增加 /server-prefix

才使路径一致。


## 5. 可引用的知识点总结

复制代码
Nginx 中,location 用于匹配请求路径,proxy_pass 用于决定转发后的最终路径。
proxy_pass 末尾加不加 '/' 会影响路径是否被替换:

- 加 '/':去掉匹配部分(`/api/`),再拼接剩余路径
- 不加 '/':完整原路径追加到 proxy_pass 后

因此,location /api/ + proxy_pass http://backend/ 是最常用的 API 转发模式。
相关推荐
程序员大阳27 分钟前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔34 分钟前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart1 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt2 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星3 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson3 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊4 小时前
CNC计算机数控加工模拟器
前端
张一凡935 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent