ricono 作ったものと、詰まった箇所の記録

「検索が遅い」と言われて調べたら、壊れていました。エラーを握りつぶすコードの見つけ方

開発データベースデバッグ

「検索が遅いんだけど」と言われました。

実際に試すと、たしかに時間がかかって、結果は0件。遅いのではなく、壊れていました。

使う人からは「遅い」「ヒットしない」としか見えません。失敗が、成功した結果として表示されていました。


これが一番たちが悪い理由

障害には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つずつ「これは本当に空が正しいのか」を見ます。

見分け方は単純で、**「空が返ったとき、それが正常なのか異常なのか、呼び出し側が判断できるか」**です。できないなら直す対象です。


今回の根本原因のほうも書いておきます

握りつぶしを直しても、遅い原因は消えません。 そちらも書きます。

落ちていたのは、部分一致の検索でした。

where name ilike '%キーワード%'

前後に % が付く部分一致は、通常のインデックスが効きません。 全行を走査するので、件数が増えると線形に遅くなります。数万件を超えたあたりで急にタイムアウトし始めます。

対処はいくつかあります。

方法 向く場面
前方一致にする('キーワード%') 「〜で始まる」で済むなら最速
全文検索インデックス 本格的に検索したい
pg_trgm 拡張 + GINインデックス 部分一致のまま速くしたい
検索対象の列を絞る そもそも全列を舐めていないか確認

一番効いたのは最後でした。複数の列を or で繋いで部分一致していたので、対象を実際に使われている列だけに絞ったら、体感できる速さになりました。


まとめ

自分のコードで return [] を書いた catch を探してみてください。たぶん1つは見つかります。

← 記事一覧