layui的ajax请求在反向代理下404,是因为其不感知代理层,请求直接发往浏览器当前域名;需通过layui.config统一配置base路径(如'/api/'),并确保Nginx的location与proxy_pass路径精准对齐(尾部斜杠必须一致),同时补全header及proxy_redirect规则。

layui 的 ajax 请求路径在反向代理下为什么会 404
因为 layui 自身不感知代理层,$.ajax() 或 layer.open({type: 2}) 发出的请求是直接走浏览器当前域名的,如果后端 API 实际部署在内网(如 http://192.168.1.100:3000),而你通过 Nginx 反代暴露为 https://app.example.com/api/,但前端代码里还写 /api/user 或 http://192.168.1.100:3000/api/user,就会触发跨域或路径错位。
- 写绝对 URL(如
http://192.168.1.100:3000/api/login)→ 浏览器直连失败(内网地址不可达) - 写相对路径(如
/api/login)→ 路径对齐依赖 Nginx 的location和proxy_pass配置是否精准,稍有偏差就 404 - 没统一配置 base URL → 各处
url:字段硬编码,改环境就得全局搜替换
用 layui.config 全局设置 base URL 最省事
不要在每个 $.ajax() 里拼地址,而是启动时用 layui.config 注入一个可变的 base,后续所有模块自动继承:
layui.config({
base: '/api/' // 注意结尾斜杠,和 Nginx location 保持一致
}).use(['jquery', 'layer'], function(){
var $ = layui.jquery;
$.ajax({
url: 'user/list', // 实际发到 /api/user/list
success: function(res){ ... }
});
});
-
base必须以/开头且以/结尾,否则拼接逻辑会出错 - 值不能写协议+域名(如
https://app.example.com/api/),否则跨域;只写路径前缀即可 - 若 Nginx 配置了子路径代理(如
location /admin/ { proxy_pass http://backend/; }),这里就填/admin/api/
Nginx 必须配合做路径对齐,否则 layui 请求仍 404
layui 发 /api/user,Nginx 得准确把这段路径转发给后端。常见错误是 proxy_pass 尾部斜杠缺失或多余:
- ✅ 正确(带尾部
/):location /api/ { proxy_pass http://192.168.1.100:3000/; }→/api/user→ 后端收到/user - ❌ 错误(无尾部
/):location /api/ { proxy_pass http://192.168.1.100:3000; }→/api/user→ 后端收到/api/user(多了一级) - ⚠️ 若后端本身监听
/api前缀,才考虑不加尾部/,但极易混淆,不推荐
同时必须补全关键 header,否则后端可能解析不到真实路径或 IP:
location /api/ {
proxy_pass http://192.168.1.100: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;
proxy_set_header X-Forwarded-Proto $scheme;
}
遇到重定向(302)时 layui 会跳错域名,得靠 proxy_redirect 拦截
后端返回 Location: http://192.168.1.100:3000/login,浏览器会直接跳去这个内网地址——必须用 proxy_redirect 改写。变量要用正则匹配,不能写死:
location /api/ {
proxy_pass http://192.168.1.100:3000/;
proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ $scheme://$host/api/$1;
}
- 这个规则把任意内网绝对重定向(如
http://localhost:3000/login)→ 改成https://app.example.com/api/login - 注意
$scheme://$host/api/$1中的/api/必须和 layui 的base、Nginx 的location完全一致 - 别用
proxy_redirect http://192.168.1.100:3000/ /api/;—— IP 或端口一变就失效
最易被忽略的是:layui 的 iframe 弹窗(layer.open({type: 2, content: '/page/user.html'}))也走同样路径逻辑,必须确保 /page/ 这类静态资源路径也在 Nginx 中做了对应代理,否则打开空白页。











