游标插入仅生效首行问题排查：多表条件批量插入需求

要把临时表#CapacityInsertData里满足多条件校验的数据插入到capacitymaster2表。已知#CapacityInsertData有3条符合循环内条件的数据，调试时用SELECT能逐行刷出这3条，但开了INSERT之后只有首行插进去了，游标循环却确实跑了3次，调过FETCH的位置也没解决。

常见错误游标代码示例 #

DECLARE @Col1 INT, @Col2 VARCHAR(50)
DECLARE capacity_cursor CURSOR FOR
    SELECT Col1, Col2 FROM #CapacityInsertData WHERE [你的过滤条件]

OPEN capacity_cursor
FETCH NEXT FROM capacity_cursor INTO @Col1, @Col2

WHILE @@FETCH_STATUS = 0
BEGIN
    -- 多条件校验逻辑
    IF EXISTS(SELECT 1 FROM capacitymaster2 WHERE Col1 = @Col1)
    BEGIN
        -- 比如更新或者跳过的逻辑
    END
    ELSE
    BEGIN
        INSERT INTO capacitymaster2(Col1, Col2) VALUES(@Col1, @Col2)
        -- 很多人会把FETCH NEXT写到这里，这就是坑！
        FETCH NEXT FROM capacity_cursor INTO @Col1, @Col2
    END
    -- 正确的位置应该是这里！
END

CLOSE capacity_cursor
DEALLOCATE capacity_cursor

1. 把FETCH NEXT移到循环体最后 #

最容易踩的坑就是把FETCH NEXT放在了IF/ELSE分支里，导致只有走ELSE分支（也就是插入那条）的时候才会取下一条数据，走其他分支的话就不会更新游标位置，循环就拿着同一个变量值跑多次，但实际没插数据。一定要把FETCH NEXT FROM ...放到循环体的最后一行，不管分支怎么执行，每次循环结束都能取下一条数据。

修正后的循环部分：

WHILE @@FETCH_STATUS = 0
BEGIN
    -- 多条件校验逻辑
    IF EXISTS(SELECT 1 FROM capacitymaster2 WHERE Col1 = @Col1)
    BEGIN
        -- 更新或跳过逻辑
    END
    ELSE
    BEGIN
        INSERT INTO capacitymaster2(Col1, Col2) VALUES(@Col1, @Col2)
    END
    -- 固定放这里，确保每次循环都取新数据
    FETCH NEXT FROM capacity_cursor INTO @Col1, @Col2
END

2. 检查变量和列的匹配度 #

确认游标查询的列数、数据类型，和INTO后面的变量完全对应，别出现列数不匹配或者类型转错的情况——要是变量没正确赋值，后续插入的可能是空值或者不符合条件的数据，看起来就像没插入。

3. 别用游标了，直接批量插（推荐） #

SQL里游标效率低还容易出错，这种批量插入场景直接用INSERT ... SELECT就行，把校验条件写到WHERE里：

INSERT INTO capacitymaster2(Col1, Col2, [其他需要的列])
SELECT 
    cid.Col1, cid.Col2, cid.[其他列]
FROM #CapacityInsertData cid
WHERE 
    -- 把原来循环里的多条件校验都放这
    NOT EXISTS(SELECT 1 FROM capacitymaster2 cm2 WHERE cm2.Col1 = cid.Col1)
    AND [你的其他校验条件，比如日期、状态之类的]

这种写法既快又不容易出逻辑问题，还不用维护游标那一堆代码。

4. 调试时打日志 #

要是非得用游标，就在循环里加个打印语句，看看每次循环的变量值对不对：

PRINT '当前循环的Col1：' + CAST(@Col1 AS VARCHAR(10)) + '，Col2：' + @Col2

通过打印结果就能知道是变量没更新，还是插入条件没满足导致没插数据。

内容的提问来源于stack exchange，提问作者Baba Ranjith