Sanitizace vyhledávacího dotazu odstraní tečky — hledání celého e-mailu nikdy nic nenajde
Příznaky
Sekce “Příznaky”- Hledání zákazníka podle útržku e-mailu (
novak) funguje, podle celého e-mailu zkopírovaného z platební brány (jan.novak@example.com) vrací prázdný seznam. - Hledání čísla objednávky nebo jména funguje — bug se projevuje jen u hodnot s tečkou.
- Nikdo si toho dlouho nevšimne, protože lidé obvykle píšou část jména; ozve se až klient, který kopíruje e-mail z výpisu brány.
Příčina
Sekce “Příčina”Dotaz se před vložením do PostgREST filtru „čistil“ příliš širokým regexem:
const q = url.searchParams.get('q')?.replace(/[,.()*\\]/g, '');query = query.or(`customer_email.ilike.%${q}%,customer_name.ilike.%${q}%`);Čárka a závorky v hodnotě by opravdu rozbily syntaxi .or() filtru, ale tečka v hodnotě je neškodná — PostgREST dělí sloupec.operátor.hodnota jen na prvních dvou tečkách. Regex ji přesto smazal, takže se hledal řetězec, který v databázi neexistuje. Jiný endpoint téhož projektu používal správný sanitizer bez tečky, proto se bug projevoval jen na jednom místě.
Řešení
Sekce “Řešení”- Jedna sdílená funkce pro čištění hodnot do filtrů, která maže jen
, ( ) \(a případně* %, pokud nechcete povolit wildcard), nikdy tečku. - Všechny endpointy ji používají — žádný vlastní
replacev route. - Dotaz se navíc dělí na slova a každé slovo je vlastní
.or()skupina (AND přes slova), takže „jan novák“ najde jméno a příjmení ve dvou sloupcích.
export function sanitizeFilterValue(v: string) { return v.replace(/[,()\\]/g, ''); }for (const term of q.split(/\s+/).filter(Boolean).map(sanitizeFilterValue)) { query = query.or(columns.map((c) => `${c}.ilike.%${term}%`).join(','));}Jak se to ověřilo
Sekce “Jak se to ověřilo”Unit test na helper: dotaz jan.novak@example.com musí projít beze změny; dotaz s ,() musí být očištěn. Po nasazení kontrola, že hledání celého e-mailu vrací objednávku.
Související
Sekce “Související”- Normalizace textu zkopírovaného z brány („Jméno
“, mailto:) patří do téhož helperu — jinak každý endpoint řeší jiný podmnožinu.