MySQL存储过程中JSON数据游标声明报错求助

你遇到的这个错误，核心原因是游标声明的SELECT语句不符合MySQL语法规范，尤其是JSON_TABLE的使用方式不对。以下是具体的排查点和解决方案：

常见错误根源 #

1. JSON_TABLE未作为FROM子句的合法部分：游标对应的SELECT必须是完整的查询语句，JSON_TABLE必须放在FROM后，且必须指定别名。
2. 声明顺序错误：MySQL存储过程中，必须先声明变量，再声明游标，最后声明HANDLER，顺序颠倒会触发语法错误。
3. JSON路径与输入结构不匹配：如果输入JSON不是数组，用$[*]会导致无数据返回，甚至语法解析错误。
4. MySQL版本不兼容：JSON_TABLE仅在MySQL 5.7.8及以上版本支持，低版本直接用会报错。

正确的存储过程示例 #

假设你的输入JSON是数组格式（比如[{"id":1,"name":"Demo项目","desc":"测试描述"},...]），以下是可运行的存储过程代码：

DELIMITER //
CREATE PROCEDURE InsertProjectDetails(IN project_json JSON)
BEGIN
    -- 1. 先声明变量：必须在游标之前
    DECLARE v_proj_id INT;
    DECLARE v_proj_name VARCHAR(255);
    DECLARE v_proj_desc TEXT;
    DECLARE done INT DEFAULT FALSE;

    -- 2. 正确声明游标：JSON_TABLE必须放在FROM后，加别名，列映射要匹配JSON结构
    DECLARE proj_cursor CURSOR FOR
        SELECT 
            jt.proj_id,
            jt.proj_name,
            jt.proj_desc
        FROM JSON_TABLE(
            project_json,
            '$[*]' COLUMNS(
                proj_id INT PATH '$.id',
                proj_name VARCHAR(255) PATH '$.name',
                proj_desc TEXT PATH '$.desc'
            )
        ) AS jt; -- 别名jt必须加，否则会触发语法错误

    -- 3. 声明游标结束的处理逻辑
    DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;

    -- 4. 打开游标循环插入
    OPEN proj_cursor;
    insert_loop: LOOP
        FETCH proj_cursor INTO v_proj_id, v_proj_name, v_proj_desc;
        IF done THEN
            LEAVE insert_loop;
        END IF;
        -- 替换成你的项目表插入语句
        INSERT INTO project_details (project_id, project_name, description)
        VALUES (v_proj_id, v_proj_name, v_proj_desc);
    END LOOP;
    CLOSE proj_cursor;
END //
DELIMITER ;

关键注意事项 #

• 如果你的输入JSON是单个对象（而非数组），将JSON_TABLE的PATH改为$即可，此时游标仅返回一行数据。
• 检查JSON路径的大小写和字段名是否完全匹配输入JSON的键名，比如JSON里是"projectName"，PATH就不能写$.name。
• 运行前确认你的MySQL版本：执行SELECT VERSION();，确保版本≥5.7.8。

内容的提问来源于stack exchange，提问作者Dronal Bhardwaj