在 nginx 中实现小程序后端接口路径重写，核心做法是利用 location 块配合 proxy_pass 指令，将前端请求的特定前缀（如 /api/）剥离或映射到后端服务的实际路径。具体操作是在 server 配置中定义一个匹配规则，使用正则表达式捕获 uri 中的剩余部分，并在 proxy_pass 中通过变量拼接目标地址，从而让小程序能直接访问统一入口，而无需关心后端具体的微服务或模块路径。
Nginx 如何配置 location 以拦截并转发 API 请求
要实现这一功能，需要在 Nginx 配置文件中添加一个 location 块，专门处理以 /api/ 开头的请求。该配置会拦截所有符合该前缀的请求，并将其代理转发至后端的 Node.js 或 Java 服务。关键在于 proxy_pass 的写法，如果 URL 中包含变量，必须确保 Nginx 版本支持且语法正确，通常建议将后端基础路径与捕获的 URI 片段进行拼接。
server {
listen 80;
server_name api.example.com;
# 拦截 /api/ 开头的请求
location ^~ /api/ {
# 获取原始 URI 中 /api/ 之后的部分
set $backend_uri $uri;
rewrite ^/api/(.*)$ /$1 break;
# 代理到后端服务，注意末尾斜杠的处理
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
上述配置中，rewrite ... break 指令会将 /api/user/login 转换为 /user/login，然后 proxy_pass 将其发送给本地 3000 端口的后端应用。这种写法确保了后端应用接收到的路径是干净的，不需要额外处理 /api 前缀。测试时，向 http://api.example.com/api/user/login 发送 POST 请求，Nginx 会将其转发给后端，后端响应后原路返回。
如何处理小程序静态资源与 API 的共存冲突
当小程序前端代码托管在同一域名下时，需要区分静态文件请求和 API 请求。Nginx 通过不同的 location 块优先级来解决这个问题。静态资源（如 JS、CSS、图片）应优先匹配精确路径或使用 ^~ 修饰符阻止正则匹配，而 API 请求则使用正则或更通用的前缀匹配。这样可以避免静态文件被错误地代理到后端，导致 404 或解析错误。
server {
listen 80;
server_name miniapp.example.com;
root /var/www/miniapp;
# 1. 优先处理静态资源，使用 ^~ 确保精确匹配后不再检查正则
location = /index.html {
try_files $uri $uri/ /index.html;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
# 2. 处理 API 请求，放在静态资源之后
location /api/ {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
}
# 3. 默认 fallback
location / {
try_files $uri $uri/ /index.html;
}
}
在这个配置中，location ~* \.(js|css...) 用于匹配所有静态文件，由于它位于 location /api/ 之前且没有冲突，Nginx 会优先处理这些请求。对于 /api/ 请求，由于静态资源扩展名不匹配，请求会落入 location /api/ 块并被代理。这种分离确保了小程序加载页面时不会因 API 路由干扰而失败，同时 API 请求也能正确到达后端服务。
当后端服务返回 502 Bad Gateway 时如何排查路径问题
如果在配置完成后访问小程序接口出现 502 错误，通常是因为 Nginx 无法连接到后端服务，或者后端服务拒绝了连接。首先检查后端服务是否在指定端口运行，例如 netstat -tlnp | grep 3000。其次，查看 Nginx 的错误日志 /var/log/nginx/error.log，确认是否有 connect() failed (111: Connection refused) 等提示。如果连接正常但路径错误，检查 proxy_pass 后的 URL 是否包含多余的前缀，导致后端路由不匹配。
