PHP 調用 SphinxClient::Query() 返回 false,無任何錯誤細節:
$res = $cl->Query($keyword, 'myIndex');
if ($res === false) {
// 這裡只知道失敗,不知原因
}
var_dump($cl->GetLastError());
GetLastError() 返回上一次操作的具體錯誤字符串,如:
Connection refused — searchd 未啟動/端口錯誤Index myIndex not found — 索引名錯誤/未構建Searchd error: ... — 服務端內部錯誤Client version mismatch — API 與 searchd 版本不兼容$cl = new SphinxClient();
$cl->SetServer('localhost', 9312);
$cl->SetConnectTimeout(3);
$cl->SetArrayResult(true);
$res = $cl->Query($searchKey, 'myIndex');
if ($res === false) {
$err = $cl->GetLastError();
$errNo = $cl->GetLastWarning(); // 警告信息
error_log("Sphinx Query Failed: [$errNo] $err | Query: $searchKey");
// 降級處理:回退 MySQL LIKE 查詢或返回空結果
$res = ['matches' => [], 'total' => 0];
}
var_dump($res); // 開發環境可直接輸出
| 錯誤信息 | 原因 | 解決 |
|---|---|---|
| Connection refused | searchd 未運行/端口錯誤/防火牆 | systemctl status searchd / telnet IP 9312 |
| Index not found | 索引名拼寫錯/未 indexer --all | indexer -c conf --all && searchd --reload |
| Max matches exceeded | 結果超過 max_matches (默認 1000) | SetLimits(0, 20, 10000) 增大第三參數 |
| Filter value out of range | 屬性值超出 32 位有符號整數 | 改用 BIGINT 屬性或字符串屬性 |
| Query too complex | EXTENDED 語法過長/嵌套過深 | 簡化查詢、拆分多次查詢 |
# csft.conf
searchd {
query_log = /var/log/sphinx/query.log
query_log_format = sphinxql # 或 text
}
重啟 searchd,日志記錄每條查詢的 SQL、耗時、匹配數,極利於性能分析。
Query() 返回 false 時,第一時間調用 GetLastError()。配合查詢日志、網絡連通性測試、索引狀態檢查,可快速定位 90% 以上問題。