为jsforce库构建日志中间件：链式调用上下文丢失问题求助

递归代理方案 #

你遇到的核心问题是链式调用返回的对象未被代理，且方法执行时丢失原上下文。要彻底解决这个问题，需要实现一个递归代理函数——不仅代理初始的sobject对象，还要对每个方法调用返回的对象也进行代理，同时强制绑定原对象的上下文。

通用代理实现代码 #

function createLoggingProxy(target, logger) {
  return new Proxy(target, {
    get(target, prop) {
      const value = target[prop];
      // 拦截函数类型的属性，添加日志逻辑
      if (typeof value === 'function') {
        return function(...args) {
          // 记录调用详情：对象标识、方法名、参数
          logger(`Salesforce API Call: ${target.name || 'SObject'}.${prop}`, args);
          // 绑定原上下文执行方法，避免this指向错误
          const result = value.apply(target, args);
          // 如果返回值是对象/函数，继续代理以支持链式调用
          if (result && typeof result === 'object') {
            return createLoggingProxy(result, logger);
          }
          return result;
        };
      }
      // 对对象类型的属性也递归代理
      if (value && typeof value === 'object') {
        return createLoggingProxy(value, logger);
      }
      return value;
    }
  });
}

// 封装你的Salesforce客户端
class SalesforceClient {
  constructor(conn) {
    this.conn = conn;
  }

  sobject(objectName) {
    const sobject = this.conn.sobject(objectName);
    // 给sobject套上日志代理
    return createLoggingProxy(sobject, (methodInfo, args) => {
      // 替换为你的实际日志逻辑，比如写入文件、上报监控系统
      console.log(`[SF LOG] ${methodInfo}, Args: ${JSON.stringify(args)}`);
    });
  }
}

使用示例 #

// 初始化jsforce连接
const conn = new jsforce.Connection({ /* 你的连接配置 */ });
await conn.login(username, password);

// 使用封装后的客户端
const sfClient = new SalesforceClient(conn);
// 链式调用正常执行，同时自动记录每一步的API调用
sfClient.sobject('Account').find({ Name: { $like: 'Test%' } }).execute((err, res) => {
  // 处理查询结果
});

其他可选方案 #

1. 重写jsforce原型方法 #

如果递归代理的开销对你的服务有影响，可以直接重写jsforce核心类的原型方法，只对需要日志的API做精准拦截：

// 重写SObject的find方法
const originalFind = jsforce.SObject.prototype.find;
jsforce.SObject.prototype.find = function(...args) {
  console.log(`[SF LOG] SObject.find 调用参数: ${JSON.stringify(args)}`);
  const query = originalFind.apply(this, args);
  
  // 同时重写Query的execute方法
  const originalExecute = query.execute;
  query.execute = function(...args) {
    console.log(`[SF LOG] Query.execute 执行`);
    return originalExecute.apply(this, args);
  };
  return query;
};

这种方式需要你梳理jsforce的类结构，适合只需要监控特定API的场景。

2. AOP切面编程 #

用AOP库（比如aop-js）给jsforce方法添加日志切面，比手动重写原型更简洁：

// 给SObject的所有方法添加前置日志
aop.before(jsforce.SObject.prototype, '*', function(methodName, args) {
  console.log(`[SF LOG] SObject.${methodName} 调用参数: ${JSON.stringify(args)}`);
});

关键注意事项 #

• 上下文绑定：必须用apply/call把方法的执行上下文绑定到原对象，否则会出现this指向错误。
• 代理边界：注意判断返回值类型，避免对字符串、数字等原始类型或Promise对象过度代理。
• 性能平衡：递归代理会带来一定性能开销，如果服务QPS极高，建议只代理核心业务用到的API方法。

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