Yii2 PJAX局部刷新需服务端用renderPartial返回片段、前端正确绑定data-pjax与容器ID，且控制器必须判断Yii::$app->request->isPjax并分支处理。
Yii2 更新数据后页面不刷新，不是“页面卡了”，而是你没告诉框架：这次响应该返回局部 HTML 片段，而不是整页重载。核心问题出在服务端渲染方式和前端 PJAX 绑定的配合上。
判断是否走 PJAX 流程：必须检查 Yii::$app->request->isPjax
Yii2 不会自动识别 PJAX 请求并切换渲染逻辑。如果你用了 Pjax::begin() 包裹内容，但控制器 action 里仍调用 $this->render()，就会返回带完整 <html> 的页面，导致 PJAX 失败并退化为整页刷新（或白屏）。
- 必须在 action 开头加判断：
if (Yii::$app->request->isPjax) { return $this->renderPartial('form', ['model' => $model]); } -
renderPartial()不加载 layout、不执行 view 中的全局初始化（如use yii\helpers\Html），只输出纯内容片段 - 漏掉这个判断，哪怕 PJAX 容器 ID、
data-pjax属性都写对了，也一定失败 - 调试时可在控制器里临时加
var_dump(Yii::$app->request->isPjax); die;确认请求头X-PJAX: true是否送达
ActiveForm 提交不刷新的关键：表单 options 要带 data-pjax
很多人在 Html::submitButton() 上加 ['data-pjax' => 'xxx']，这是错的。PJAX 表单提交的绑定对象是整个 form 标签，不是按钮。
- 正确写法：
$form = ActiveForm::begin(['options' => ['data-pjax' => 'post-form']]); - 对应 PJAX 容器必须有相同 ID：
Pjax::begin(['id' => 'post-form']) - 如果表单不在 PJAX 容器内，或者容器 ID 和
data-pjax值不一致，提交后照样整页跳转 - 不要在
ActiveForm::end()后再放Pjax::end()—— 表单必须被完整包裹在 PJAX 容器内，否则 DOM 事件委托失效
更新成功后保持 UI 同步：别只改数据，要手动触发重绘
比如你在 PJAX 容器里更新了一条记录，服务端返回新 HTML，但页面上的 yii\grid\GridView 行数没变、操作按钮没更新，大概率是因为你没清空旧缓存或没重载 JS 行为。
- 确保 GridView 的
dataProvider在每次请求时都是新实例（避免复用旧对象导致分页/排序状态残留） - 如果用了自定义 JS 操作（如行内编辑、状态开关），PJAX 替换 DOM 后这些绑定会丢失，需在
$.pjax.success或$(document).on('pjax:success', ...)里重新初始化 - 避免在视图中写内联 JS 初始化逻辑（如
$('#grid').yiiGridView(...)），应统一收口到 PJAX 回调中 - 开发阶段可临时加
console.log('pjax loaded')到回调里，确认是否真被触发
最常被忽略的是：PJAX 成功替换内容后，浏览器地址栏 URL 不变，但开发者容易误以为“没刷新”——其实 DOM 已更新，只是没触发 history.pushState。若需 URL 同步，得手动配置 Pjax::begin(['enablePushState' => true])，但这会带来路由管理复杂度，多数场景不需要。
