MySQL 5.7调试存储过程需建InnoDB引擎的sp_debug_log表,用JSON_OBJECT封装数据、INSERT SET语法写入,并在过程开头设autocommit=1确保日志不被事务回滚。

MySQL 5.7 没有断点调试器,所谓“调试复杂存储过程”,本质是让执行轨迹可追溯、状态可捕获、日志不被事务吞掉——不是暂停代码,而是把关键节点稳稳写进表里。
为什么不能直接用 SELECT 打点输出
在过程里写 SELECT 'debug:', @var 看似简单,但多数环境会报 Commands out of sync; you can't run this command now。这不是 SQL 错了,是客户端(比如 JDBC 默认配置、某些命令行工具)没开多结果集支持。MySQL Workbench 和 DBeaver 默认能接住,但生产应用几乎都不行。更关键的是:这种输出不落盘、不可查、无法关联上下文,循环跑十轮后你根本不知道第 7 轮的 @status 是什么。
必须建一张专用的 sp_debug_log 表
这张表不是可选项,是唯一能兼顾可追溯、防注入、事务独立的日志载体。它得满足四个硬条件:
- 引擎必须是
InnoDB,且建表语句显式写ENGINE=InnoDB(避免因sql_mode或版本差异落到 MyISAM) - 字段精简但够用:
id(自增主键)、proc_name(VARCHAR(64))、step(VARCHAR(128))、data(JSON 类型)、created_at(TIMESTAMP DEFAULT CURRENT_TIMESTAMP) -
data字段必须用JSON_OBJECT()封装,禁止字符串拼接:JSON_OBJECT('uid', @uid, 'cnt', @cnt)✅;CONCAT('{\"uid\":', @uid, '}')❌ - 插入语句必须用
INSERT INTO sp_debug_log SET ...语法,不用VALUES,避免引号嵌套和注入风险
在存储过程中安全写日志的三步动作
不是每行都记,而是有策略地打点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 开头加开关控制:
SET @debug_mode = IFNULL(@debug_mode, 0);,后续所有日志都包在IF @debug_mode THEN ... END IF;里 - 关键分支前/后记一次,比如
IF @amount > 0 THEN INSERT ... SET step = 'before_deduct'; END IF; - 循环内只记首尾或异常点,别在
WHILE体里无条件INSERT——10 万次循环就是 10 万次磁盘写,性能直接崩 - 务必在过程最开头加
SET autocommit = 1;,否则日志会被主事务卷走,ROLLBACK后全消失
卡住时怎么 2 分钟定位到具体哪条 SQL
SHOW FULL PROCESSLIST 只告诉你 “有个 CALL 在跑”,真正拖慢的是它内部某条 SQL。必须切到 performance_schema 查线程内部:
- 先取线程 ID:
SELECT ID FROM INFORMATION_SCHEMA.PROCESSLIST WHERE INFO LIKE 'CALL%my_proc%'; - 再查该线程正在执行的 SQL:
SELECT EVENT_NAME, SQL_TEXT FROM performance_schema.events_statements_current WHERE THREAD_ID = ? AND SQL_TEXT IS NOT NULL; - 如果已卡死,立刻看扫描行数:
SELECT * FROM performance_schema.events_statements_history WHERE THREAD_ID = ? ORDER BY TIMER_START DESC LIMIT 5;,重点关注ROWS_EXAMINED异常高的那条
真正难的不是写日志,是决定在哪打点、打多少、以及每次 INSERT 前是否真需要 SET autocommit = 1 ——漏掉这一句,日志就等于没写。










