Powerdrill PHP SDK 报 400 错误主因是 outlier_spec 结构不合规：字段缺失（如 IQR 缺 column）、类型错误（threshold 写成字符串）、非法字符（列名含点号）或浮点精度失真；须用 json_encode(..., JSON_THROW_ON_ERROR) 校验、sprintf 控制小数位、ISO8601 时间去毫秒、轮询加延迟与退避、手动精确设置 cURL header 并管理 token 有效期。
Powerdrill PHP SDK 报 400 Bad Request 且提示 "invalid outlier spec"
这是最常见的集成卡点：Powerdrill 的异常值检测（outlier detection）配置项不满足其服务端校验规则，PHP 端发过去的 JSON body 被直接拒收。
根本原因不是 PHP 代码写错，而是 Powerdrill 对 outlier_spec 结构有严格要求——它不接受空字段、非法类型或未声明的字段。比如传了 "method": "iqr" 却漏掉必需的 "column"，或把 "threshold" 写成字符串 "1.5"（实际要 number 类型）。
- 务必用
json_encode($spec, JSON_THROW_ON_ERROR)发送前校验结构，避免 PHP 自动转义 null/float 导致类型丢失 -
column必须是原始数据中的列名（区分大小写），不能带空格或点号（如"user.id"需先在 Powerdrill 中 alias 成"user_id"） - IQR 方法必须同时提供
method: "iqr"和threshold: 1.5（float，不能是 int 或 string）；Z-score 方法则需threshold: 3.0且method: "zscore"
PHP 数值精度导致 Powerdrill 返回空结果或错误分组
Powerdrill 后端对浮点数敏感，尤其在 outlier_spec.threshold 或预处理的 filter 条件中。PHP 默认的 float 在序列化时可能产生尾部精度误差（如 3.0 变成 3.0000000000000004），触发服务端数值比较失败。
- 用
sprintf('%.1f', $threshold)显式控制小数位（Powerdrill 官方文档明确建议阈值保留 1 位小数） - 避免用
round($x, 1)—— 它返回 float，仍可能有二进制表示误差；sprintf返回字符串，JSON encode 后是精确字面量 - 如果 outlier 检测基于时间窗口（如
"window": "7d"），确保 PHP 生成的start_time/end_time是 ISO8601 格式且无毫秒（Powerdrill 不接受"2024-05-01T00:00:00.123Z"，需截断为"2024-05-01T00:00:00Z"）
异步任务状态轮询时 getJobStatus() 返回 "pending" 却迟迟不更新
Powerdrill 的 outlier 检测属于计算密集型任务，PHP 客户端若按固定间隔（如每秒）轮询，容易被限流或错过状态变更。更关键的是：它的 job_id 在提交后不会立即可查，存在几秒的注册延迟。
立即学习“PHP免费学习笔记（深入）”；
- 首次调用
getJobStatus($jobId)前，先 sleep(2) —— 直接查可能返回404或空响应，SDK 往往静默转成"pending" - 不要用 while(true) 疯狂轮询；改用指数退避：
sleep(2), sleep(4), sleep(8)，最大等待不超过 60 秒（Powerdrill 默认超时是 90 秒，但业务侧应设更短兜底） - 检查响应中的
"progress"字段（如果有）：它比"status"更早反映真实进度，值为0.0表示刚入队，1.0才算完成
用 cURL 手动调用 Powerdrill API 时 Cookie 或 Header 被自动覆盖
PHP 的 cURL 默认会设置一些 header（如 User-Agent、Host），而 Powerdrill 要求精确的 Content-Type: application/json 和带有效 token 的 Authorization: Bearer xxx。一旦 PHP 自动注入冲突 header，就会返回 401 或 415。
- 显式调用
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers)，且$headers必须包含全部必要项 —— 不要依赖 cURL 补全 - 禁用自动 header：加
curl_setopt($ch, CURLOPT_HTTPHEADER, []);再重设，避免遗留旧 header - Token 过期是静默失败主因：Powerdrill 的
Bearertoken 有效期通常仅 1 小时，PHP 端需缓存 token 并在401响应后主动刷新，不能靠重试掩盖
Powerdrill 的异常值接口对输入格式和时序非常“较真”，PHP 侧最常栽在类型隐式转换、JSON 序列化精度、以及 HTTP header 控制权丢失上。与其反复调试报错，不如在构造 outlier_spec 后先用 var_dump(json_encode($spec)) 看一眼最终发出去的字符串长什么样。
