使用C#通过Google Data Transfer API迁移Drive数据时遇空引用异常

我之前在使用服务账号+域范围委派做Drive数据迁移时，也碰到过一模一样的空引用异常，结合你的场景，给你几个针对性的排查方向：

• 先确认服务账号客户端初始化是否完整
  域范围委派要求服务账号必须模拟一个拥有Admin SDK权限的域管理员用户，而且要正确加载密钥文件、指定Data Transfer的API scope。如果这一步出错，DataTransferService实例很可能是null，后续调用API自然会触发异常。
  比如要避免这种错误写法：

  // 错误：模拟用户为空，或者scope未正确添加
  var credential = GoogleCredential.FromFile("key.json")
      .CreateScoped(new[] { "wrong-scope" })
      .CreateWithUser("");
  var service = new DataTransferService(new BaseClientService.Initializer { HttpClientInitializer = credential });
  

  正确的初始化应该包含正确的scope和有效的管理员用户邮箱：

  var scopes = new[] { DataTransferService.Scope.AdminDatatransfer };
  var credential = GoogleCredential.FromFile("service-account-key.json")
      .CreateScoped(scopes)
      .CreateWithUser("admin@your-domain.com"); // 必须是域内有权限的管理员
  var service = new DataTransferService(new BaseClientService.Initializer
  {
      HttpClientInitializer = credential,
      ApplicationName = "Drive Transfer Tool"
  });
  

• 检查Transfer对象的必填字段是否都已正确赋值
  根据API定义，Transfer对象有几个必填项：

  1. OldOwnerUserId：源用户的ID（推荐用用户ID，部分场景邮箱也能识别，但ID更稳定）
  2. NewOwnerUserId：目标用户的ID
  3. ApplicationDataTransfers：必须包含Drive的固定应用ID 580827758096

  如果其中任何一个字段为null或者未初始化，比如ApplicationDataTransfers直接设为null，调用Insert方法时就会触发空引用。正确的示例：

  var transferRequest = new Transfer
  {
      OldOwnerUserId = "1234567890abcdef", // 源用户ID
      NewOwnerUserId = "0987654321fedcba", // 目标用户ID
      ApplicationDataTransfers = new List<ApplicationDataTransfer>
      {
          new ApplicationDataTransfer
          {
              ApplicationId = "580827758096" // Drive的固定应用ID
          }
      }
  };
  

• 在异常行前加调试检查
  堆栈跟踪已经指向了抛出异常的代码行，你可以在那一行之前加断点或者日志，检查所有涉及的对象是否为null。比如如果是调用service.Transfers.Insert(transfer).Execute()时出错，就检查service、transfer这两个对象是否都已正确实例化。

• 注意API响应的空值处理
  有时候即使请求没问题，API返回的响应可能为空（比如权限不足导致的隐性错误），如果你直接访问响应的属性，也会触发空引用。建议先判断响应是否为null再处理：

  var transferResponse = service.Transfers.Insert(transferRequest).Execute();
  if (transferResponse != null)
  {
      Console.WriteLine($"Transfer created with ID: {transferResponse.Id}");
  }
  else
  {
      Console.WriteLine("API returned empty response");
  }
  

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