理解SP.clientContext.executeQueryAsync的数据拉取顺序问题

这个问题我太熟悉了！之前在处理SharePoint用户批量查询的时候也踩过一模一样的坑，我来给你拆解一下原因和解决办法：

你的两次console.log表现不一样，核心原因在于SharePoint的clientContext.executeQueryAsync是异步操作，具体来说：

1. 第一次console.log(userProfileProperties)和console.log(userProfilePropertiesForUser)是在你创建完本地对象后同步打印的，这时候还没向SharePoint服务器发起请求，所以顺序完全和你的循环调用顺序一致——毕竟是你按顺序一个个创建出来的对象。
2. 但调用clientContext.load()和clientContext.executeQueryAsync()之后，每个请求都会异步发送到SharePoint服务器处理。服务器处理每个用户属性查询的速度可能不一样（比如有的用户数据在缓存里，有的需要从数据库读取），哪个请求先处理完，对应的回调就会先触发。这就导致回调里的userProfileProperties顺序和你循环调用的顺序脱节了。

另外还要注意：你每次调用getUserProperties都新建了一个SP.ClientContext实例，每个上下文的异步请求都是独立的，它们的完成顺序完全不受你循环调用顺序的控制，这进一步加剧了顺序混乱的问题。

有两种常用的方案，根据你的场景选就行：

方案1：批量请求（推荐） #

把所有用户的查询请求放到同一个客户端上下文里，一次性发送给服务器。SharePoint会按你添加请求的顺序返回结果，这样回调里的顺序就和原循环顺序一致了。

示例代码：

function batchGetUserProfiles(emailList, parentCtrl) {
  var deferred = $.Deferred();
  var clientContext = new SP.ClientContext.get_current();
  var peopleManager = new SP.UserProfiles.PeopleManager(clientContext);
  var profilePropertyNames = ["PictureURL", "PreferredName", "SPS-JobTitle", "Department", "WorkPhone", "WorkEmail", "PersonalSpace"];
  var userProfileRequests = [];

  // 循环收集所有用户的查询请求
  emailList.forEach(function(targetUser) {
    var userProfilePropertiesForUser = new SP.UserProfiles.UserProfilePropertiesForUser(
      clientContext, targetUser, profilePropertyNames
    );
    var userProfileProperties = peopleManager.getUserProfilePropertiesFor(userProfilePropertiesForUser);
    // 把每个用户的请求和标识存起来，方便后续对应
    userProfileRequests.push({
      targetUser: targetUser,
      profileProperties: userProfileProperties
    });
    clientContext.load(userProfilePropertiesForUser);
  });

  // 一次性执行所有请求
  clientContext.executeQueryAsync(function(sender, args) {
    // 这里的结果顺序和emailList完全一致
    var results = userProfileRequests.map(function(req) {
      return {
        user: req.targetUser,
        profileData: req.profileProperties.get_data()
      };
    });
    deferred.resolve(results);
  }, function(sender, args) {
    console.error("批量获取用户属性失败:", args.get_message());
    deferred.reject(null);
  });

  return deferred.promise();
}

方案2：顺序执行请求 #

如果因为某些限制不能批量请求，你可以用Promise链式调用的方式，让每个请求完成后再执行下一个，保证顺序和循环一致。比如用jQuery的Promise链式操作：

先修改原getUserProperties函数，让它在成功时返回实际的属性数据：

getUserProperties = function (targetUser, userCount, parentCtrl) { 
  var deferred = $.Deferred(); 
  var clientContext = new SP.ClientContext.get_current(); 
  var peopleManager = new SP.UserProfiles.PeopleManager(clientContext); 
  var profilePropertyNames = ["PictureURL", "PreferredName", "SPS-JobTitle", "Department", "WorkPhone", "WorkEmail", "PersonalSpace"]; 
  var userProfilePropertiesForUser = new SP.UserProfiles.UserProfilePropertiesForUser( 
    clientContext, targetUser, profilePropertyNames); 
  var userProfileProperties = peopleManager.getUserProfilePropertiesFor(userProfilePropertiesForUser); 

  clientContext.load(userProfilePropertiesForUser); 
  clientContext.executeQueryAsync(function (sender, args) { 
    // 返回实际的属性数组
    deferred.resolve(userProfileProperties.get_data()); 
  },function (sender, args) { 
    console.error("获取用户属性失败:", args.get_message());
    deferred.reject(null); 
  }); 

  return deferred.promise(); 
}

然后用链式调用实现顺序执行：

function sequentialGetUserProfiles(emailList, parentCtrl) {
  var promiseChain = $.Deferred().resolve().promise();
  var results = [];

  emailList.forEach(function(targetUser) {
    promiseChain = promiseChain.then(function() {
      return getUserProperties(targetUser, null, parentCtrl)
        .then(function(profileData) {
          // 按循环顺序存入结果
          results.push({
            user: targetUser,
            profile: profileData
          });
        });
    });
  });

  // 所有请求完成后返回结果数组
  return promiseChain.then(function() {
    return results;
  });
}

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