Caddy redirect koncového lomítka zahodí query string (ztráta utm/gclid)
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Statický web má kanonické URL s koncovým lomítkem (/sluzba/), server je ale přes 301 normalizuje na /sluzba. Všechno „funguje“, stránky se zobrazí. Až při testovací poptávce z landing page přijde do CRM payload s utm: "" a landing_url bez parametrů, přestože byla stránka otevřena s ?utm_source=…&gclid=…. Reklamní atribuce v CRM a v GTM/GA chybí pro veškerý provoz z reklam, který míří na URL s lomítkem.
Root cause
Sekce “Root cause”Redirect v Caddyfile skládal cíl jen z regexové skupiny cesty:
@trailingSlash path_regexp trslash ^(.+)/$redir @trailingSlash {re.trslash.1} 301{re.trslash.1} je část {path}, a {path} v Caddy query string neobsahuje. Odpověď je 301 Location: /sluzba — prohlížeč na novou URL přejde bez ?…. Skripty na stránce čtou location.search až po redirectu, takže UTM/gclid nevidí; sessionStorage fallback nepomůže, protože na první stránce parametry nikdy nebyly.
Stejný snippet byl zkopírovaný do šesti site bloků na sdíleném serveru, takže chyba postihla všechny weby najednou.
Fix
Sekce “Fix”Dvě varianty redirectu podle toho, zda query existuje (Caddy neumí podmíněně vynechat ?):
@trailingSlashQ { path_regexp trslashq ^(.+)/$ expression `{query} != ""`}redir @trailingSlashQ {re.trslashq.1}?{query} 301
@trailingSlash { path_regexp trslash ^(.+)/$ expression `{query} == ""`}redir @trailingSlash {re.trslash.1} 301Ověření před reloadem: caddy validate --config <kopie> --adapter caddyfile; po reloadu:
curl -sI "https://<web>/sluzba/?utm_source=test&gclid=abc" | grep -i location# očekáváno: location: /sluzba?utm_source=test&gclid=abcJak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -n "redir .*{path}\|redir .*{re\." Caddyfile— každý zásah bez{query}/{uri}je podezřelý. V nginx totéž proreturn 301 $uribez$is_args$args, v ApacheRedirectMatchbezQSA/[QSA]u RewriteRule. - Anti-pattern: normalizace URL (lomítko, lowercase, www) postavená na cestě místo na celém URI; testování redirectů jen na „holé“ URL bez parametrů.
- Lepší přístup: u normalizačních redirectů vždy přenášet query (
{uri}-ekvivalent), a do smoke testů po deployi přidat jeden request s?utm_source=test, který kontrolujeLocation. Ideálně nechat kanonické URL a server v souladu (buď všude s lomítkem, nebo bez), aby redirect vůbec nenastával.
Sister bugs / související
Sekce “Sister bugs / související”- Statický web, kde se po změně hostingu rozbily interní URL assetů (jiná normalizace cest) — viz záznam o apex takeover statického webu v této kategorii.
- Ztráta locale při klientské navigaci s natvrdo zapsanou kanonickou cestou (frontend) — stejná třída: část URL se při „opravě“ tiše zahodí.