Yii2生产环境SQL语法错误被静默处理，需同时启用YII_DEBUG和YII_ENV='dev'、禁用errorHandler的throwExceptions、并在web/index.php顶部添加error_reporting(E_ALL)和ini_set('display_errors', '1')才能显示真实报错。
Yii2 默认在生产环境（YII_ENV = 'prod'）下会隐藏 SQL 语法错误的详细信息，只返回空白页或 500 错误，真实报错被 ErrorHandler 拦截并静默处理——这不是代码没报错，而是框架主动“捂住了嘴”。
确认是否已启用调试模式
SQL 语法错误要浮出来，前提是整个错误链不被拦截。必须同时满足：
-
defined('YII_DEBUG') or define('YII_DEBUG', true);在web/index.php开头存在且未被注释 -
defined('YII_ENV') or define('YII_ENV', 'dev');同样在web/index.php中设置为'dev' - 确保没有在配置中覆盖
'errorHandler' => ['throwExceptions' => false]（默认是false，但显式设为true可能导致白屏）
强制 PHP 显示所有错误（绕过 Yii 拦截）
即使开了 YII_DEBUG，某些底层 PHP 解析错误（如 PDO 预处理失败、mysqli 报错）仍可能被跳过。最直接的办法是在 web/index.php 最顶部插入：
error_reporting(E_ALL);
ini_set('display_errors', '1');注意：这两行必须放在 require __DIR__ . '/../vendor/autoload.php'; 之前，否则部分错误来不及捕获。
查 SQL 错误时别只盯 ActiveRecord 方法
很多 SQL 语法错误其实不出现在 find() 或 save()，而藏在手写 SQL 里，比如：
-
Yii::$app->db->createCommand("SELECT * FROM user WHERE status = 1 AND created_at > '2026-08-xx'")->queryAll();—— 日期格式错误、引号不闭合、关键字拼错（form而非from）都会触发1064错误 - 用
createCommand()执行 DDL（如ALTER TABLE）时，MySQL 版本不兼容语法（如ALGORITHM=INSTANT在 8.0.29+ 才支持） -
Query::where()中传入非法数组结构，例如['>', 'created_at', null]导致生成created_at > NULL，部分 MySQL 模式下会报错
这类错误只有开启调试 + 强制显示错误后，才能在页面上看到完整堆栈和原始 SQL。
控制台命令执行 SQL 报错看不到？加 --verbose
运行迁移或自定义 console 命令时，SQL 错误常被吞掉。正确做法是：
- 执行
php yii migrate/up --verbose，它会让 PDO 异常完整输出，包括报错 SQL 和绑定参数 - 如果命令里用了
Yii::$app->db->createCommand()->execute()，--verbose会打印出实际执行语句，比看日志文件快得多 - 避免在 console 命令里手动
try/catch吞掉异常——除非你明确要降级处理，否则让它自然抛出
真正容易被忽略的是：SQL 语法错误在 console 下默认不显示上下文 SQL，必须靠 --verbose 主动打开；而 web 请求下，哪怕开了 YII_DEBUG，若没加 error_reporting 两行，PDO 的底层错误依然不会透出。
