Yii2 AJAX表单提交需确保后端只返回标准JSON：控制器用asJson()或设Response::FORMAT_JSON，禁用布局和额外输出；前端应校验Content-Type再解析，避免parse error。
Yii2 中使用 AJAX 提交表单时，如果后端返回的不是标准 JSON 格式（比如混入了 PHP 错误、调试输出、BOM 头、空格或 HTML 内容），前端 jQuery 的 $.ajax 或 $.post 就会触发 parse error，控制台报错类似：Unexpected token 或 Invalid JSON。这不是 Yii2 验证逻辑的问题，而是响应体被污染导致 JSON 解析失败。
检查响应内容是否为纯净 JSON
在浏览器开发者工具的 Network 标签下，找到对应 AJAX 请求，点击进入，切换到 Response 或 Preview 面板，直接查看原始返回内容。常见污染源包括：
- PHP 开启了
display_errors = On，且代码中存在 Notice/Warning（如未定义变量、数组下标不存在），错误信息直接输出到响应流 - 控制器或视图文件开头/结尾存在空白符、UTF-8 BOM 头（尤其 Windows 编辑器保存时容易带入）
- 在
action中误用了echo、var_dump()、print_r()等调试语句 - 布局文件（layout）被意外加载，比如
$this->layout = 'main'没关闭，导致返回 HTML 包裹的 JSON - 全局事件（如
beforeAction）中输出了内容
确保 AJAX 响应只输出 JSON
Yii2 推荐用 JsonResponseFormatter 统一处理 JSON 输出。在控制器中避免手动 echo json_encode(...)，改用：
return $this->asJson([
'success' => false,
'errors' => $model->getErrors()
]);
该方法会自动设置 Content-Type: application/json，并禁用布局渲染。若需手动控制，务必加：
\Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;-
return [...];（不要 echo，不要 exit）
前端 AJAX 配置与错误处理建议
不要依赖默认的 dataType: 'json' 强制解析，先检查状态码和响应类型：
$.post(url, data)
.done(function(response, textStatus, jqXHR) {
if (jqXHR.getResponseHeader('Content-Type')?.includes('application/json')) {
// 安全解析
try {
const data = typeof response === 'string' ? JSON.parse(response) : response;
// 后续处理
} catch (e) {
console.error('JSON parse failed:', e, response);
}
}
})
.fail(function(jqXHR) {
console.error('AJAX failed:', jqXHR.status, jqXHR.statusText);
// 查看 jqXHR.responseText 判断实际返回内容
});
也可在全局 AJAX 设置中统一拦截非 JSON 响应：
$(document).ajaxComplete(function(event, xhr, settings) {
const contentType = xhr.getResponseHeader('Content-Type');
if (contentType && contentType.includes('application/json') === false && xhr.responseText.trim().length > 0) {
console.warn('Non-JSON response detected:', xhr.responseText.substring(0, 100));
}
});
快速定位污染源的小技巧
在出问题的 action 开头加入：
ob_end_clean(); // 清除已开启的输出缓冲 \Yii::$app->response->isSent = false; // 重置发送状态（谨慎使用） \Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
同时临时关闭所有可能输出的组件：注释掉 layout、关闭日志中的 trace 级别输出、检查 bootstrap 中是否有打印语句。再逐个恢复，观察何时出现污染。
不复杂但容易忽略。
