「検索が遅い」と言われて調べたら、壊れていました。エラーを握りつぶすコードの見つけ方
「検索が遅いんだけど」と言われました。
実際に試すと、たしかに時間がかかって、結果は0件。遅いのではなく、壊れていました。
- SQLが8.3秒かかってタイムアウト(Postgresのエラーコード
57014) - アプリ側がそのエラーを受け取って、空配列を返していた
- 画面には「該当なし」とだけ出た
使う人からは「遅い」「ヒットしない」としか見えません。失敗が、成功した結果として表示されていました。
これが一番たちが悪い理由
障害には3種類あります。
| 種類 | 気づきやすさ |
|---|---|
| 画面が真っ白になる | すぐ分かる |
| エラーメッセージが出る | すぐ分かる |
| 成功したふりをして、空の結果を返す | 🔴 誰も気づかない |
3番目は、使う人が「データが無いんだな」と解釈してしまいます。 報告すら上がってきません。今回も「遅い」という別の症状として報告されました。
犯人はこの形のコードです
見覚えがあると思います。
// ❌ よくある書き方
async function search(keyword) {
try {
const rows = await db.query(sql, [keyword]);
return rows;
} catch (e) {
console.error(e);
return []; // ← ここ
}
}
catch で [] を返しています。画面を落とさないための配慮として書かれることが多く、悪意はありません。
ただしこれをやると、「データが0件」と「取得に失敗した」が区別できなくなります。 呼び出し側には同じ [] が届きます。
console.error は出ていますが、本番のサーバーログを毎日見ている人はいません。
どう書き換えるか
失敗は失敗として返す。 画面側で「0件」と「エラー」を別々に表示します。
// ✅ 区別できる形
async function search(keyword) {
const rows = await db.query(sql, [keyword]); // 落ちたらそのまま投げる
return rows;
}
画面側:
try {
const rows = await search(kw);
setResult(rows); // 0件なら「該当なし」
} catch (e) {
setError("検索に失敗しました"); // 失敗は失敗と出す
}
落としたくない気持ちは分かります。でも**「静かに嘘をつく」より「正直に失敗する」ほうが、結局ダメージが小さい**です。
どうしても握りつぶすなら、せめて区別できる戻り値にしてください。
return { ok: false, rows: [], reason: "timeout" };
自分のコードから見つける
catch の中で空を返している場所を探します。
# 空配列・null・0 を返している catch
grep -rn -A3 "catch" src/ | grep -E "return (\[\]|null|0|\{\})"
ヒットしたら、1つずつ「これは本当に空が正しいのか」を見ます。
- 正しい例:設定ファイルが無いときに既定値を返す(無いのが正常)
- 危ない例:DB・API・ファイル読み込みの失敗を空にする(失敗を隠している)
見分け方は単純で、**「空が返ったとき、それが正常なのか異常なのか、呼び出し側が判断できるか」**です。できないなら直す対象です。
今回の根本原因のほうも書いておきます
握りつぶしを直しても、遅い原因は消えません。 そちらも書きます。
落ちていたのは、部分一致の検索でした。
where name ilike '%キーワード%'
前後に % が付く部分一致は、通常のインデックスが効きません。 全行を走査するので、件数が増えると線形に遅くなります。数万件を超えたあたりで急にタイムアウトし始めます。
対処はいくつかあります。
| 方法 | 向く場面 |
|---|---|
前方一致にする('キーワード%') |
「〜で始まる」で済むなら最速 |
| 全文検索インデックス | 本格的に検索したい |
| pg_trgm 拡張 + GINインデックス | 部分一致のまま速くしたい |
| 検索対象の列を絞る | そもそも全列を舐めていないか確認 |
一番効いたのは最後でした。複数の列を or で繋いで部分一致していたので、対象を実際に使われている列だけに絞ったら、体感できる速さになりました。
まとめ
- 「遅い」という報告は、「壊れている」かもしれない。 症状と原因は一致しない
catchで空を返すと、失敗と0件が区別できなくなる- 落としたくないなら、せめて
{ ok: false }のように区別できる形にする - 部分一致(
%...%)はインデックスが効かない。 件数が増えると必ず詰まる
自分のコードで return [] を書いた catch を探してみてください。たぶん1つは見つかります。