PHP调用Salesforce Einstein API必须使用JWT Bearer Flow认证，禁用用户名密码或Session ID；需配置Connected App、RSA 2048私钥签名JWT，动态获取预测字段名，严格控制cURL超时与重试策略，并安全处理Base64图像响应。
PHP调用Salesforce Einstein API必须用JWT Bearer Flow
直接用用户名密码或Session ID去请求Einstein API会失败，401 Unauthorized是常态。Salesforce强制要求Einstein Prediction/Analytics类API走OAuth 2.0的JWT Bearer Flow，因为涉及模型推理和数据访问权限校验，Session机制不被信任。
关键点在于：你得提前在Salesforce中注册一个Connected App，启用JWT Token Exchange，并上传公钥；PHP端用私钥签名JWT，再POST到https://login.salesforce.com/services/oauth2/token换Access Token。
- 私钥必须是RSA 2048位、PKCS#8格式（
-----BEGIN PRIVATE KEY-----），OpenSSL生成时别漏掉-traditional参数，否则Salesforce拒收 - JWT的
iss必须填Connected App的Consumer Key，sub填管理员用户邮箱（且该用户已授权API访问+Einstein许可） -
aud固定为https://login.salesforce.com（沙盒环境用https://test.salesforce.com） - 签名算法只能是
RS256，用firebase/php-jwt库比手写更稳，但注意v6+版本默认不兼容openssl_sign()旧行为
预测结果返回字段名与PHP数组键名不一致
Einstein Prediction API返回的JSON里，预测字段叫probabilities，但实际结构嵌套深、键名动态——比如你训练的模型叫Lead_Score_v2，它返回的字段可能是Lead_Score_v2_Prediction和Lead_Score_v2_Confidence，而不是固定prediction或confidence。
PHP代码里如果硬写$resp['prediction']会报Undefined index。必须先读取模型元数据接口：/services/data/vXX.X/supportedPredictions，拿到predictionField和probabilityField这两个字段名，再动态取值。
- 模型ID（如
0D1xx000000XXXXXX）不能从UI上抄，得用API查，否则/vXX.X/predictions/{modelId}直接404 - 响应里的
probabilities是个对象，不是数组，json_decode($json, true)后要用array_values()转成索引数组才能foreach - 置信度值是字符串（如
"0.923"），PHP做数值比较前记得(float)强转，否则"0.9" > "0.85"可能因字典序出错
cURL超时导致Einstein预测请求随机失败
不是代码逻辑问题，而是Einstein模型推理本身有波动：简单模型~200ms，复杂NLP模型可能卡到3.5s以上。PHP默认curl_setopt($ch, CURLOPT_TIMEOUT, 30)看似够用，但Salesforce网关（尤其是沙盒）常在2.8s左右主动断连，返回{"message":"Service Unavailable"}，HTTP状态码却是503。
解决方式不是盲目加超时，而是分层控制：
- 设
CURLOPT_TIMEOUT_MS为4500（4.5秒），避免整数秒截断误差 - 必须同时设
CURLOPT_CONNECTTIMEOUT_MS为1000，防止DNS或TCP握手拖死整个请求 - 加上
CURLOPT_HTTPHEADER里显式声明Connection: close，避免cURL复用连接时被Salesforce后台回收导致后续请求静默失败 - 对
503响应要重试（最多1次），但400/401/403类错误绝不重试——那是鉴权或参数问题
PHP处理Einstein返回的Base64图像需绕过output_buffering
调用/services/data/vXX.X/einstein/imagePrediction返回的是含base64字段的JSON，但如果你在Laravel或CodeIgniter等框架里直接echo json_encode($data)，框架可能开启output_buffering，导致Base64字符串被意外截断（尤其大图），前端解码后图片损坏。
真正安全的做法是：先用base64_decode()取出二进制图像数据，再用header('Content-Type: image/jpeg')直出，跳过JSON封装环节。
- 别用
file_get_contents()读Base64字符串再解码——内存暴涨，10MB图片会吃掉30MB RAM（Base64膨胀约33%） - 解码后立刻
ob_end_clean()清空所有输出缓冲区，再echo $binary，否则header可能失效 - 如果必须返回JSON，把Base64字段改名为
image_data而非image，避免某些前端库（如Axios）自动尝试解析二进制内容
Einstein的响应结构、认证链路和网络行为都和普通REST API不同，最常被忽略的是JWT签发时间戳精度——Salesforce要求iat和exp必须是整数秒，且exp - iat ≤ 300，用microtime(true)直接填会因小数部分被拒绝。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
