Salesforce API 24升级后创建EnterpriseConnection的变化及连接故障排查

核心问题分析 #

你遇到的问题源于高版本Salesforce API（36及以上）在安全协议、连接配置上有更严格的要求，旧代码的配置无法适配这些规则。

具体修复步骤 #

1. 更新TLS协议版本
   新版本API已废弃TLSv1和TLSv1.1，仅支持TLSv1.2及以上协议。修改系统属性：

   System.setProperty("https.protocols", "TLSv1.2,TLSv1.3");
   

2. 补充ConnectorConfig必要配置
   高版本API需要额外的安全和性能配置，仅设置SessionId和ServiceEndpoint已不足以建立连接：

   metadataConfig.setCompression(true); // 启用API压缩，符合高版本规范
   metadataConfig.setSocketFactory(javax.net.ssl.SSLSocketFactory.getDefault()); // 强制使用现代SSL工厂
   

3. 验证Session ID兼容性
   确保使用的Session ID是通过对应目标API版本（36/60）生成的，旧版本Session ID无法适配高版本端点，可重新生成后重试。

调整后的完整代码示例 #

System.setProperty("https.protocols", "TLSv1.2,TLSv1.3");
ConnectorConfig metadataConfig = new ConnectorConfig();
metadataConfig.setSessionId(sf_sessionId);
metadataConfig.setServiceEndpoint(sf_sessionURL);
// 新增高版本API必需配置
metadataConfig.setCompression(true);
metadataConfig.setSocketFactory(javax.net.ssl.SSLSocketFactory.getDefault());

LOG.info("Attempting new SFDC connection with sessionID: " 
            + sf_sessionId + " URL: " + sf_sessionURL);

EnterpriseConnection enterpriseConnection = Connector.newConnection(metadataConfig);

内容的提问来源于stack exchange，提问作者Wayne B.