SSIS Script Task（C#）在VS正常运行，SSMS执行成功却无效果

排查方向及解决方案 #

1. 确认文件路径的上下文一致性 #

VS中运行包基于本地用户上下文，而SSMS执行包（尤其是通过SQL Server Agent）基于SQL Server所在服务器的上下文：

• 若D:\是本地电脑磁盘，而SQL Server部署在远程服务器，服务器的D:\可能是完全不同的路径甚至不存在；
• 建议改用UNC共享路径（如\\YourServerName\DataFiles\IQVIAData\...）替代本地盘符路径，确保VS和SSMS执行时访问的是同一位置的文件。

2. 添加错误捕获与日志记录 #

原脚本无错误处理逻辑，即使File.Move执行失败仍会返回Success，导致无法定位问题。修改脚本加入异常捕获和日志输出：

public void Main()
{
    bool fireAgain = true;
    try
    {
        string sourcePath = @"D:\DataFiles\IQVIAData\BrickWeekly\BrickWeeklyData\201226_FACT_ALL_SALES_147.txt";
        string targetPath = @"D:\DataFiles\IQVIAData\BrickWeekly\BrickWeeklyData\ASD.txt";

        // 验证源文件存在
        if (!File.Exists(sourcePath))
        {
            Dts.Events.FireError(0, "文件重命名失败", $"源文件不存在：{sourcePath}", string.Empty, 0);
            Dts.TaskResult = (int)ScriptResults.Failure;
            return;
        }

        // 验证目标文件夹存在
        string targetDir = Path.GetDirectoryName(targetPath);
        if (!Directory.Exists(targetDir))
        {
            Dts.Events.FireError(0, "文件重命名失败", $"目标文件夹不存在：{targetDir}", string.Empty, 0);
            Dts.TaskResult = (int)ScriptResults.Failure;
            return;
        }

        File.Move(sourcePath, targetPath);
        Dts.Events.FireInformation(0, "文件重命名成功", $"已将文件从 {sourcePath} 重命名为 {targetPath}", string.Empty, 0, ref fireAgain);
        Dts.TaskResult = (int)ScriptResults.Success;
    }
    catch (Exception ex)
    {
        Dts.Events.FireError(0, "文件重命名异常", $"错误信息：{ex.Message}\n堆栈跟踪：{ex.StackTrace}", string.Empty, 0);
        Dts.TaskResult = (int)ScriptResults.Failure;
    }
}

修改后执行包时，可在SSIS执行日志中查看具体错误信息，精准定位问题。

3. 验证SSIS代理账户的实际权限 #

即使使用管理员账户作为SSIS代理，仍需确认：

• 该账户对源文件和目标文件夹拥有读取、写入、修改权限；
• 若使用本地盘符路径，代理账户能访问到该磁盘（映射驱动器无法被服务账户识别，必须用本地物理路径或UNC）；
• 在SQL Server Agent作业的步骤配置中，已明确指定使用该SSIS代理账户（而非默认的SQL Server Agent服务账户）。

4. 检查文件是否被占用 #

若文件被其他进程（如Excel、ETL工具）锁定，File.Move会静默失败。可在脚本中添加文件可访问性验证：

try
{
    using (FileStream fs = File.Open(sourcePath, FileMode.Open, FileAccess.ReadWrite, FileShare.None))
    {
        // 文件未被占用，可执行重命名
    }
}
catch (IOException ex)
{
    Dts.Events.FireError(0, "文件被占用", $"文件 {sourcePath} 正在被其他进程使用：{ex.Message}", string.Empty, 0);
    Dts.TaskResult = (int)ScriptResults.Failure;
    return;
}

5. 确认SSIS包的执行位置 #

在SSMS中执行包时，注意选择的执行模式：

• 在服务器上执行：包运行在SQL Server所在服务器，路径需对应服务器的文件系统；
• 在本地执行：包运行在本地电脑，此时需确保本地SQL Server Agent代理账户有足够权限访问本地文件。

内容的提问来源于stack exchange，提问作者Hüseyin