Jenkins自动化运行时访问网络驱动器及C#代码访问异常排查

一、Jenkins自动化过程中访问网络驱动器的方法 #

• 配置Jenkins服务运行账户：默认Jenkins使用本地系统账户（Local System），该账户无网络访问权限。需切换为具备网络共享访问权限的域账户或本地管理员账户：
  1. 打开服务管理器，找到Jenkins服务
  2. 右键→属性→登录，选择「此账户」，输入有权限的账户名和密码
  3. 重启Jenkins服务
• 使用UNC路径而非驱动器号：避免依赖用户会话映射的驱动器，直接采用\\servername\sharename\filepath格式，例如File.Copy(@"C:\local\file.txt", @"\\fileserver\shared\dest.txt")
• 在构建脚本中临时映射网络驱动器：若必须使用驱动器号，可在构建步骤中添加命令行脚本：
  Windows cmd示例：

  net use Z: \\fileserver\shared /user:domain\username password /persistent:no
  # 执行文件传输操作
  net use Z: /delete
  

  注意：明文密码存在安全风险，建议通过Jenkins凭据管理存储密码，再以变量形式引用
• 确认网络共享权限设置：为Jenkins运行账户分配共享文件夹的「读取/写入」权限，同时检查文件夹的NTFS权限是否匹配

二、C# File.Copy在Jenkins运行出错的解决办法 #

核心原因：Visual Studio以当前登录用户运行，该用户已映射网络驱动器且具备访问权限；但Jenkins服务运行在独立会话，使用的账户无对应权限或无法识别用户会话的驱动器映射。

解决步骤：

• 替换为UNC路径：将代码中的驱动器号路径（如Z:\dest.txt）替换为UNC路径\\fileserver\shared\dest.txt，这是最可靠的解决方案
• 检查Jenkins服务账户权限：确认Jenkins运行账户对目标网络共享具备读写权限，可手动使用该账户登录Jenkins节点，尝试访问共享文件夹验证
• 避免依赖用户映射的驱动器：用户手动映射的驱动器仅在当前用户会话有效，Jenkins服务无法访问这些映射
• 代码中添加身份验证（可选）：若无法修改Jenkins账户，可在C#代码中通过网络凭据访问共享，示例：

  using System;
  using System.IO;
  using System.Net;
  
  class FileCopyHelper
  {
      public static void CopyToNetworkShare(string source, string dest, string username, string password)
      {
          var credential = new NetworkCredential(username, password);
          using (new NetworkConnection(Path.GetDirectoryName(dest), credential))
          {
              File.Copy(source, dest, true);
          }
      }
  }
  
  // 辅助类：建立网络连接
  public class NetworkConnection : IDisposable
  {
      private string _networkName;
  
      public NetworkConnection(string networkName, NetworkCredential credentials)
      {
          _networkName = networkName;
          var netResource = new NativeMethods.NETRESOURCE
          {
              dwType = NativeMethods.RESOURCETYPE_DISK,
              lpRemoteName = networkName
          };
          var result = NativeMethods.WNetAddConnection2(netResource, credentials.Password, credentials.UserName, 0);
          if (result != 0)
          {
              throw new InvalidOperationException($"无法连接到网络共享：错误码 {result}");
          }
      }
  
      public void Dispose()
      {
          NativeMethods.WNetCancelConnection2(_networkName, 0, true);
      }
  
      private static class NativeMethods
      {
          public const int RESOURCETYPE_DISK = 0x00000001;
  
          [StructLayout(LayoutKind.Sequential)]
          public class NETRESOURCE
          {
              public int dwScope = 0;
              public int dwType = 0;
              public int dwDisplayType = 0;
              public int dwUsage = 0;
              public string lpLocalName = "";
              public string lpRemoteName = "";
              public string lpComment = "";
              public string lpProvider = "";
          }
  
          [DllImport("mpr.dll")]
          public static extern int WNetAddConnection2(NETRESOURCE lpNetResource, string lpPassword, string lpUserName, int dwFlags);
  
          [DllImport("mpr.dll")]
          public static extern int WNetCancelConnection2(string lpName, int dwFlags, bool fForce);
      }
  }
  

  注意：禁止硬编码密码，需从Jenkins凭据中读取后传入

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