Web 服务器与网关 / 系统课时
按路径路由多个服务
按路径路由多个服务
本课解决一个网关入口面对多个后端服务时的路由问题。通过 Nginx 的 location 匹配和 proxy_pass 配置,可以根据 URI 前缀将用户、订单、文件等请求转发到不同服务,并正确处理路径保留与移除。
学习目标
- 掌握基于 URI 前缀的服务路由方式。
- 理解 proxy_pass 是否带路径对转发结果的影响。
- 配置多服务入口并验证请求流向。
使用路径匹配构建网关路由
在微服务架构中,客户端通常只访问一个网关地址,由网关根据路径决定目标服务。例如 /users/ 进入用户服务,/orders/ 进入订单服务,/files/ 进入文件服务。
Nginx 使用 location 匹配请求路径,再通过 proxy_pass 将请求转发到对应上游。
配置多个服务路由
下面示例展示三个不同路径转发到不同服务。proxy_pass 后端地址和路径写法会影响最终发送给上游的 URI。
nginx
http {
upstream user_service {
server user_backend;
}
upstream order_service {
server order_backend;
}
server {
listen <PORT>;
location /users/ {
proxy_pass http://user_service;
}
location /orders/ {
proxy_pass http://order_service;
}
}
}预期结果
text
/users/profile 请求转发到 user_service,并保留原始 URI。
/orders/list 请求转发到 order_service,并保留原始 URI。理解路径保留与前缀移除
proxy_pass 的路径写法决定是否替换匹配部分。例如:
nginx
location /api/ {
proxy_pass http://backend/;
}预期结果
text
客户端请求:/api/users
上游收到:/users如果不写尾部路径:
nginx
location /api/ {
proxy_pass http://backend;
}预期结果
text
客户端请求:/api/users
上游收到:/api/users实际配置中需要根据后端接口设计决定是否保留网关前缀。
实现接口版本路由
路径路由也常用于 API 版本隔离,例如 /v1/ 和 /v2/ 使用不同服务。
nginx
server {
listen <PORT>;
location /v1/ {
proxy_pass http://api_v1/;
}
location /v2/ {
proxy_pass http://api_v2/;
}
}预期结果
text
/v1/users 请求进入 api_v1 服务。
/v2/users 请求进入 api_v2 服务。排查路径路由异常
当请求进入错误服务时,优先检查三个位置:location 匹配规则、proxy_pass 路径格式、后端实际接收的 URI。
可以通过增加访问日志查看最终请求路径,也可以在后端打印收到的请求 URI,确认网关转换是否符合预期。
常见错误包括更具体路径没有优先匹配、正则 location 抢占请求,以及 proxy_pass 尾斜杠导致路径变化。
按自己的节奏,确认真正理解。