layui如何全局设置ajax请求头

小强同学_8396

小强同学_8396

2026-09-12

331人浏览

原创

最可靠的方式是用layui.config配置ajaxsetup(layui≥2.8),否则须用$.ajaxprefilter;因layui组件内部请求走封装链路,$.ajaxsetup对其无效,而$.ajaxprefilter可动态注入token并兼容所有请求。

layui如何全局设置ajax请求头

最可靠的方式是用 layui.config 配置 ajaxSetup,前提是 Layui 版本 ≥ 2.8;若版本较低或需动态读取 token,则必须用 $.ajaxPrefilter

为什么 $.ajaxSetup 在 Layui 里经常失效

因为 Layui 内部多数请求(如 table.renderform.on('submit') 的 AJAX 模式)走的是 layui.jquery.ajax 封装链路,而非原生 jQuery 的 $.ajax。直接在 layui.use 里调用 $.ajaxSetup 只影响手动写的 $.get/$.post,对组件内部请求基本没用。

常见错误现象:

  • table.render 请求不带 Authorization
  • token 刷新后,旧值仍被固写在 $.ajaxSetup
  • form.on('submit') 开启 AJAX 后仍跳转页面(说明根本没走 jQuery 请求链)

layui.config({ ajaxSetup: { headers: {...} } }) 的正确用法

这是 Layui 2.8+ 官方支持的全局配置方式,会自动注入到 layui.ajaxtable.request、AJAX 提交的 form 等所有内部请求中。

实操要点:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • 必须在 layui.use 之前 调用,否则无效
  • headers 中的值是静态快照,不能自动响应 localStorage.getItem('token') 的变化
  • 若需动态 token,得配合 $.ajaxPrefilter 或重写 layui.ajax
  • 示例写法:
    layui.config({<br>  ajaxSetup: {<br>    headers: {<br>      'Authorization': 'Bearer ' + (localStorage.getItem('access_token') || '')<br>    }<br>  }<br>});<br>layui.use(['table', 'form'], function(){ ... });

$.ajaxPrefilter 是唯一能动态注入 token 的方案

它在每次 jQuery 请求发出前触发,可实时读取 localStoragesessionStorage,且兼容 Layui 组件内部调用(只要它们底层用了 layui.jquery.ajax)。

关键细节:

  • 必须放在 layui.use('jquery', function(){}) 回调内,确保用的是 Layui 封装的 $
  • 务必加域名/路径过滤,避免把 token 错带到 CDN 或统计接口:if (options.url.startsWith('/api/')) { ... }
  • 不要和 $.ajaxSetup 混用,否则 header 可能被覆盖或重复
  • 示例:
    layui.use('jquery', function(){<br>  var $ = layui.jquery;<br>  $.ajaxPrefilter(function(options, originalOptions, jqXHR){<br>    var token = localStorage.getItem('access_token');<br>    if (token && options.url.startsWith('/api/')) {<br>      options.headers = options.headers || {};<br>      options.headers.Authorization = 'Bearer ' + token;<br>    }<br>  });<br>});

table.render 单独设 header 必须用 beforeSend

table.render({ headers: {...} }) 是无效写法 —— Layui 2.8.x 及更早版本根本不识别这个字段。真正生效的方式只有两种:

  • table.set({ headers: {...} }) 设全局默认(但无法区分多表格)
  • render 中用 beforeSend 注入原生 XHR:
    table.render({<br>  url: '/api/list',<br>  beforeSend: function(xhr){<br>    var token = localStorage.getItem('access_token');<br>    if(token) xhr.setRequestHeader('Authorization', 'Bearer ' + token);<br>  }<br>});
  • beforeSend 是唯一能操作原始 XMLHttpRequest 实例的方式,适合需要精细控制的场景(比如跨域凭据、自定义超时)

真正容易被忽略的是:token 动态性与请求链路的耦合。无论选哪种方式,只要 token 存储在客户端且可能刷新,就必须确保 header 注入时机晚于 token 更新动作——$.ajaxPrefilter 是目前唯一能天然满足这点的机制。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui框架 ajax layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2240

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

340

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2073

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1121

6

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.09

2823

4

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

2023.11.14

794

3

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

2024.03.12

6046

8

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5210

6

Go 语言 HTTP 编程与中间件开发教程合集
Go 语言 HTTP 编程与中间件开发教程合集

全面讲解 Go 语言 HTTP 编程的核心知识,涵盖 net/http 标准库的 Server/Handler/HandlerFunc 体系、DefaultServeMux 路由注册与自定义路由器、Request / ResponseWriter 请求响应处理、中间件(Middleware)链式设计模式与常见中间件(日志/CORS/认证/限流)开发、http.Client 的超时配置与连接池管理、Cookie / Session 处理、

2026.05.08

381

31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
jQuery官方API文档
jQuery官方API文档

共0课时 | 0人学习

Symfony教程(入门篇+基础篇)
Symfony教程(入门篇+基础篇)

共18课时 | 1.8万人学习