MySQL存储过程INOUT参数仅支持标量类型或会话级用户变量,不支持JSON等复合类型;需用VARCHAR/JSON类型传JSON字符串并在过程内解析。

INOUT参数不能传“对象”,只能传标量值或用户变量
MySQL 存储过程不支持传递 JSON 对象、数组、结构体或任何复合数据类型作为 INOUT 参数——它只接受标量类型(如 INT、VARCHAR、DECIMAL、DATETIME 等)或 @variable 形式的会话级用户变量。所谓“传对象”,实际是开发者误将 JSON 字符串或拼接后的字符串当成了对象。
常见错误现象:CALL proc_with_inout('{"id":1,"name":"alice"}') —— 这其实是把一个 JSON 字符串当作 INOUT 参数传入,但参数定义若为 INOUT id INT,就会触发隐式转换失败,报错类似 Truncated incorrect INTEGER value: '{"id":1,"name":"alice"}'。
- INOUT 参数必须在调用前已存在且类型兼容:比如
SET @data := 42;,再CALL proc(@data); - 如果想模拟“对象行为”,可用
VARCHAR或JSON类型参数接收 JSON 字符串,再在过程内用JSON_EXTRACT()解析 - 不要在 INOUT 参数上做
SELECT ... INTO赋值,除非确认目标是局部变量;对 INOUT 参数应直接SET inout_param := ...
INOUT 参数必须显式赋值,且不能参与表达式计算
INOUT 参数不是返回值,也不支持像函数那样嵌入 SQL 表达式中。写 SELECT my_proc(@x) 是语法错误,MySQL 不允许存储过程调用出现在 SELECT 列表或 WHERE 条件里。
正确做法是:先用用户变量承载初始值,调用后该变量内容即被过程内修改覆盖。
- 定义时需明确类型:
CREATE PROCEDURE inc_counter(INOUT counter INT) BEGIN SET counter := counter + 1; END; - 调用前必须初始化:
SET @c := 5;,否则CALL inc_counter(@c)会把@c当作NULL处理,结果仍是NULL - 调用后直接读取:
SELECT @c;—— 不需要额外SELECT或OUT接收 - 过程内不可对 INOUT 参数做算术以外的隐式操作,例如
SET inout_param := CONCAT(inout_param, '_suffix')前必须确保其类型是字符串类
跨存储过程传递 INOUT 值必须依赖 @ 用户变量
局部变量(DECLARE 定义)的作用域仅限当前过程,无法被其他过程读写。INOUT 参数能“带回”新值,本质是因为你传的是同一个会话级用户变量的引用。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
典型错误:在一个过程里 DECLARE v_id INT DEFAULT 100;,然后 CALL other_proc(v_id) —— 这传的是值副本,other_proc 内部改了也影响不到 v_id。
- 正确跨过程通信方式:
SET @shared_id := 100; CALL proc_a(@shared_id); CALL proc_b(@shared_id); SELECT @shared_id; - 所有涉及 INOUT 的过程都必须声明对应参数为
INOUT param_name type,类型要严格一致(INT和UNSIGNED INT视为不同) - 避免在多个并发连接中复用同一
@变量名,它们是会话级的,不会冲突,但逻辑易混淆
用 JSON 字符串模拟对象时,INOUT 参数要配 VARCHAR/JSON 类型
如果你真需要“传对象”,唯一可行路径是把对象序列化为 JSON 字符串,用 VARCHAR 或 JSON 类型的 INOUT 参数承载,并在过程内解析/重组。
示例:CREATE PROCEDURE update_user_info(INOUT user_json JSON) BEGIN SET user_json := JSON_SET(user_json, '$.status', 'active'); END;
- 调用前:
SET @u := '{"id": 123, "name": "bob"}'; CALL update_user_info(@u); SELECT @u; - 注意
JSON类型从 MySQL 5.7+ 支持,低版本只能用VARCHAR(1024)并手动校验格式 - 过程内不能直接
SET inout_param := JSON_OBJECT(...)后再传给另一个过程,除非下一个过程也声明为JSON类型参数 - 性能上无额外开销,但 JSON 解析比原生字段慢,高频调用场景建议拆成独立字段传 IN 参数
复杂点在于:INOUT 的“双向性”是假象——它只是让用户变量在调用前后可读可写,背后没有对象引用或内存共享。容易被忽略的是类型一致性检查往往滞后到执行期才报错,而错误提示位置和真实原因常不匹配。










