Přeskočit na obsah

Caddy redirect koncového lomítka zahodí query string (ztráta utm/gclid)

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

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} 301

Ověření před reloadem: caddy validate --config <kopie> --adapter caddyfile; po reloadu:

Terminál
curl -sI "https://<web>/sluzba/?utm_source=test&gclid=abc" | grep -i location
# očekáváno: location: /sluzba?utm_source=test&gclid=abc

Jak 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éž pro return 301 $uri bez $is_args$args, v Apache RedirectMatch bez QSA/[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ý kontroluje Location. 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í.
Přidal aiarchitekt.cz · 2. 11. 2026 1:00
Provozuje aiarchitekt.cz