SQL Server存储过程Bulk Insert报错：参数替换路径时语法错误

这个问题我太熟了！SQL Server的BULK INSERT有个很坑的点——它不支持直接用变量作为文件路径，必须用动态SQL来拼接执行，这就是你报Msg 102和Msg 319错误的根源。

先看看你大概率写错的存储过程代码（是不是类似这样？）：

CREATE PROCEDURE carga_masiva
    @ruta NVARCHAR(255)
AS
BEGIN
    BULK INSERT tu_tabla
    FROM @ruta
    WITH (
        FIELDTERMINATOR = ',',
        ROWTERMINATOR = '\n',
        FIRSTROW = 2
    );
END

这种写法直接把变量@ruta塞给FROM子句，SQL Server会把它当成语法错误，因为BULK INSERT要求这里必须是字符串常量。

正确的解决方法：用动态SQL拼接执行 #

你需要把BULK INSERT语句拼接成动态SQL字符串，再通过sp_executesql执行，同时用QUOTENAME处理路径变量，避免语法错误和SQL注入风险：

CREATE PROCEDURE carga_masiva
    @ruta NVARCHAR(255)
AS
BEGIN
    SET NOCOUNT ON;

    DECLARE @sql NVARCHAR(MAX);

    -- 拼接动态SQL，用QUOTENAME把路径转成带单引号的字符串常量
    SET @sql = N'
        BULK INSERT tu_tabla
        FROM ' + QUOTENAME(@ruta, '''') + N'
        WITH (
            FIELDTERMINATOR = '','',
            ROWTERMINATOR = ''\n'',
            FIRSTROW = 2,
            TABLOCK -- 可选，提升批量插入性能
        );
    ';

    -- 执行动态SQL
    EXEC sp_executesql @sql;
END

几个关键注意点： #

• 权限问题：一定要确保SQL Server的服务账户（不是你的登录账户）有CSV文件所在路径的读取权限！比如文件在本地电脑，SQL Server用的是Local System账户，那它可能访问不到你的用户文件夹，最好把文件放到共享目录或者调整服务账户权限。
• 特殊字符处理：QUOTENAME(@ruta, '''')会自动给路径加上单引号，如果路径里本身有单引号，它会转义成两个单引号，避免语法错误。
• 动态SQL安全：用QUOTENAME而不是直接拼接''' + @ruta + '''，能有效防止SQL注入攻击，比如有人恶意传入带单引号的路径搞破坏。

如果你的表结构或者CSV格式有特殊情况，比如有引号包裹字段、不同的行终止符，直接调整WITH子句里的参数就行。

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