讲师中心 微信公众号
AI工具推荐 视频效率加速

layui如何全局设置ajax请求头

小强同学_8396

小强同学_8396

发布时间:2026-09-12 08:44:59

|

331人浏览过

|

来源于php中文网

原创

最可靠的方式是用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 是目前唯一能天然满足这点的机制。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

更多
ajax教程
ajax教程

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

2240

2023.06.14

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

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

340

2023.08.31

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

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

2073

2023.11.15

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

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

1121

2024.09.24

http500解决方法
http500解决方法

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

2823

2023.11.09

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

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

794

2023.11.14

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

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

6046

2024.03.12

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

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

5210

2024.08.16

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.4万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.6万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn