必须同时满足三件事：强制php层输出错误、确保yii_debug=true、在业务代码中显式try/catch捕获并处理deadlock异常，否则死锁报错会被静默吞掉或仅显示空白500页。
Yii2 的死锁异常（ERROR 1213）默认不显示在页面上，它会被框架的 ErrorHandler 拦截并转为白屏 500，除非你主动让它“露出来”。
为什么死锁报错看不见？
不是 PHP 没抛出异常，而是 Yii2 在 YII_DEBUG = false（生产模式）下会静默处理所有未捕获异常，包括 MySQL 报的 ERROR 1213 (40001): Deadlock found when trying to get lock。它被 yii\db\IntegrityException 或 yii\db\Exception 包裹后，直接进 errorAction 或返回空白页——你根本看不到原始 SQL 和死锁上下文。
即使开了 YII_DEBUG = true，你也只能看到“内部服务器错误”，因为死锁是数据库层回滚事务后抛给 PHP 的，而 Yii 的调试器默认不渲染底层 PDO 异常的完整 message。
如何让死锁异常真正显示出来？
必须同时满足三件事：
- 强制 PHP 层输出错误：在
web/index.php开头加error_reporting(E_ALL); ini_set('display_errors', '1'); - 确保
YII_DEBUG = true（否则ErrorHandler直接吞掉堆栈） - 在业务代码里显式捕获并打印：死锁异常不会自动冒泡到前端视图，得你自己
try/catch
示例写法：
try {
$transaction = Yii::$app->db->beginTransaction();
$product = Product::find()->where(['id' => 1])->forUpdate()->one();
$product->stock -= 1;
$product->save();
$transaction->commit();
} catch (\yii\db\Exception $e) {
if (strpos($e->getMessage(), 'Deadlock found') !== false) {
\Yii::error('Deadlock occurred: ' . $e->getMessage(), __METHOD__);
// 这里可以 throw 新异常、记录日志、或返回友好提示
throw new \RuntimeException('操作冲突，请重试', 503);
}
$transaction->rollBack();
throw $e;
}
为什么不能只靠 errorAction 显示死锁？
errorAction（比如 site/error）只处理未被捕获的顶层异常，但死锁往往发生在事务中间，且 Yii 的 save()、updateAll() 等方法内部已做了 try/catch 并简单 re-throw，不会触发全局错误处理器。更关键的是：
- 开发期
YII_DEBUG = true时，errorAction被绕过，直接走调试页——但调试页对PDOException只显示摘要，不展开 SQL 和锁信息 - 死锁异常的
$e->errorInfo数组里才有真正的 MySQL 错误码（40001）和 SQLSTATE，不手动 inspect 就丢掉了 -
renderException()方法默认不处理PDOException，它只响应HttpException子类
真正有用的死锁信息不在 PHP 页面上
别指望靠刷新网页看到死锁详情。MySQL 的死锁现场只存在两处：
-
SHOW ENGINE INNODB STATUS\G输出里的LATEST DETECTED DEADLOCK段（但只保留最后一次，且服务重启即清空） - MySQL 错误日志（需提前配置
innodb_print_all_deadlocks = ON和有效log_error路径）
PHP 层能做的，只是把 ERROR 1213 捕获后记进应用日志，并附上当前事务 ID、用户 ID、请求 URL——这些才是线上排查时真正可关联的线索。页面上显示“请重试”就够了，真要定位根因，得去翻 MySQL 日志，而不是等它在浏览器里弹出来。
