ThinkPHP 8.0数据库事务失败报500错误的真实原因是PDO静默吞错、框架转义掩盖及Nginx拦截，需五步排查：一、入口文件顶部加ini_set('display_errors','1')和error_reporting(E_ALL)强制暴露PDO异常；二、确认表引擎为InnoDB、异常穿透事务层、Db连接统一；三、手动事务中commit与rollback必须严格配对；四、PDO需显式设置ATTR_ERRMODE为EXCEPTION；五、用INFORMATION_SCHEMA.INNODB_TRX诊断并KILL残留事务。
PHP 8.0 网站数据库事务失败时，页面常直接报 500 错误且无具体提示，真实原因被层层拦截——PDO 静默吞错、ThinkPHP 转义掩盖、Nginx 拦截错误页，导致开发者在黑盒中反复试错，浪费大量调试时间。
第一步：强制暴露底层 PDO 异常
在入口文件 public/index.php 最顶部（必须在 require autoload 之前）插入两行：
ini_set('display_errors', '1'); error_reporting(E_ALL);
这一步操作起来很简单，但能绕过 php.ini 和 Nginx 的双重屏蔽，让 PDOException 的完整 message 和 trace 直接打在浏览器上。若仍为空白，检查 Nginx 配置中是否启用了 fastcgi_intercept_errors on;，临时注释掉它。
立即学习“PHP免费学习笔记（深入）”；
第二步：确认事务三要素是否全部满足
事务失败不是框架“不干活”，而是三个硬性前提中至少一个缺失：
方法一：查表引擎是否为 InnoDB
执行 SHOW CREATE TABLE user;（把 user 换成你实际操作的表名），看末尾是否为 ENGINE=InnoDB。MyISAM、MEMORY 等引擎完全不支持事务，MySQL 会静默忽略 ROLLBACK 指令，数据已落盘却无法撤回。
方法二：验证异常是否穿透到事务层
ThinkPHP 的 Db::transaction() 仅在闭包内抛出未捕获的 Exception 时才触发自动回滚。如果闭包里写了 try-catch 却没 throw $e;，异常就被吞掉，事务照常 commit。
方法三：检查 Db 连接是否统一
所有 Db::name('xxx') 操作必须共用同一连接实例。若混用 Db::connect() 自定义连接或跨模型调用不同配置，事务边界即失效——就像在两个银行柜台同时办业务，无法保证一笔转账原子性。
第三步：手动事务中 commit/rollback 必须严格配对
第一步：Db::startTrans();
第二步：将全部数据库操作包裹在 try 块中
第三步：成功后调用 Db::commit();
第四步：catch 中必须调用 Db::rollback();，且不能留空
【漏写 rollback 会导致连接长期卡在 active transaction 状态，后续同连接的 SELECT FOR UPDATE 可能无限等待】。常见陷阱是只写了 startTrans 和 commit，却把 catch 块写成 catch (\Exception $e) { Log::error($e); }——日志写了，但回滚没做，锁资源就此泄漏。
第四步：PDO 层面强制启用异常模式
即使使用 ThinkPHP，其底层仍是 PDO。若项目中存在直连 PDO 的代码（如导出、定时任务），必须确保创建实例后立即设置：
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
PHP 8.0+ 虽默认开启该模式，但部分老旧迁移项目或自定义封装中仍可能保留 PDO::ERRMODE_SILENT。不设这个，INSERT 失败、外键冲突、字段超长等错误全被转成 false 返回，后续语句继续执行，最终 commit 成功，而你只看到部分数据写入。
第五步：MySQL 层诊断卡住的事务
当 PHP 脚本超时、被 kill 或 nginx 断连后，MySQL 连接可能未释放，事务持续挂起。此时执行：
SELECT * FROM information_schema.INNODB_TRX\G
重点看 TRX_STATE 是否为 ACTIVE、TRX_STARTED 时间是否异常久远、TRX_QUERY 是否为空或卡在某条语句。若发现残留事务，记录 TRX_MYSQL_THREAD_ID 后执行 KILL [thread_id]; 主动清理。这一步不能跳过，否则新请求可能因锁等待而集体阻塞。
