应直接使用request()->ispjax()判断，因其内部自动处理大小写归一化和空格trim，比手动读x-pjax请求头更可靠；pjax请求须仅返回模板片段，禁用redirect、json及完整布局。
直接用 request()->isPjax() 就行，别自己解析 X-PJAX 请求头——ThinkPHP 6+ 已内置支持，且比手动判断更可靠。
为什么 request()->isPjax() 比手动读 header 更稳妥
ThinkPHP 的 isPjax() 内部不仅检查 X-PJAX 请求头是否存在，还额外做了大小写归一化和空格 trim，避免因前端发请求时 header 名写成 x-pjax、X-pjax 或带空格导致误判。手动写 $this->request->header('X-PJAX') 容易漏掉这些边界情况。
常见错误现象：局部刷新时返回完整页面、嵌套 layout、甚至触发 redirect —— 往往就是控制器里用了 isAjax() 或手写 header 判断，但没真正进入 pjax 分支。
-
isAjax()返回 false：pjax 是普通 GET/POST，不是 XMLHttpRequest，不能靠它识别 -
isPjax()在 ThinkPHP 6.0+ 中已稳定可用，无需额外扩展或重写 Request 类 - 若项目升级过框架版本（比如从 TP5 升到 TP6），注意旧代码里自定义的 pjax 判断逻辑要删掉，否则可能和内置方法冲突
控制器中正确响应 PJAX 请求的典型结构
关键不是“怎么判断”，而是“判断后怎么做”。pjax 请求必须只输出模板片段，不能调 redirect()、不能 return JSON、不能 render 完整 layout。
- 在方法开头加
if (request()->isPjax()) { return $this->fetch('partial/list'); } - 确保
fetch()指向的是无 layout 的纯内容模板（比如不包含、） - 禁止在 pjax 分支里调用
$this->success()或$this->error()，它们默认走 JSON 或 redirect - 如果用了中间件做权限拦截，需确认该中间件不会对 pjax 请求强制跳转登录页（比如未登录时返回 302，会导致 pjax 加载失败白屏）
前端 pjax 初始化与后端响应不匹配的典型表现
pjax 白屏、控制台报 parsererror、Network 面板看到返回的是完整 HTML —— 这些都不是前端 JS 的问题，而是后端没真正识别或响应 pjax 请求。
- 检查浏览器 Network → Headers → Request Headers 是否真有
X-PJAX: true（某些 pjax 插件默认不带，需显式配置） - 用 curl 测试：
curl -H "X-PJAX: true" http://yoursite.com/list，看返回是否为预期片段 - 若测试返回正常但页面不生效，大概率是前端 pjax 的
container选择器写错，或目标元素被 JS 动态移除过 - TP6 默认开启 CORS，但如果用了自定义中间件或 Nginx 代理，可能意外过滤了
X-PJAX头（Nginx 需配proxy_pass_request_headers on;）
最常被忽略的一点：pjax 请求的 URL 必须本身可独立访问。如果路由绑定了登录中间件，又没对 pjax 请求做放行，就会 302 跳转，导致前端收到重定向响应而非 HTML 片段——这时 isPjax() 根本没机会执行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
