# Hibaelhárítás

> Gyakori HelloIMG- és LW Image-hibák: kulcs, domain, keret, a régi URL-ek átirányítása nginx alatt, adatbázis, WebP-támogatás, lassú háttérfutás, kihagyott képek.

A legtöbb gondot a [Tester](https://hub.hellowp.io/hu/docs/hellotools/helloimg/tester/) fül előre jelzi, ezért először azt nézd meg. A képenkénti okokat a [Napló](https://hub.hellowp.io/hu/docs/hellotools/helloimg/statisztika-naplo/) fül mutatja.

## Kulcs és kapcsolat

| Amit látsz | Ok | Mit tegyél |
|---|---|---|
| „Nincs csatlakoztatva” / „A konvertálás bekapcsolásához illessz be egy API-kulcsot.” | Nincs kulcs. | [Másold ki a kulcsot a console-ból](https://hub.hellowp.io/hu/docs/hellotools/helloimg/konzol/kulcs-masolasa/), illeszd be, ments, majd **Kapcsolat tesztelése**. |
| „A kapcsolatteszt sikertelen: …” | Rossz vagy rotált kulcs, vagy a HelloIMG nem érhető el. | Másold be újra a kulcsot; a Tester „HelloImg API” sora mutatja a pontos hibát. |
| „Ez az API-kulcs a(z) X oldalhoz tartozik, ez az oldal viszont Y.” | A kulcs másik domainhez szól (pl. staging és éles, vagy domainváltás után). | Vedd fel ezt a domaint is a console-ban, és az ő kulcsát használd. Reverse proxy vagy multisite mögött: [`lw_img_site_host` szűrő](https://hub.hellowp.io/hu/docs/hellotools/helloimg/konstansok/). |
| Bulk: „A futás leállt, mert az API elutasította a kulcsot…” | A kulcsot futás közben rotálták vagy törölték. | Írd be az új kulcsot, és indítsd újra; a maradék képek a sorban vannak. |
| Bulk: a futás leállt, elfogyott a keret | A havi keret elfogyott. | Csomagváltás után indítsd újra; a maradék képek a sorban vannak. |

## A régi URL-ek átirányítása (nginx)

Ha a tömeges optimalizálás nem indul, és ezt látod: „Ez a szerver maga válaszol a hiányzó képfájlokra…”, akkor a webszerver (jellemzően az nginx) maga ad 404-et a nem létező képekre. Így a WordPress nem tudja a régi `.jpg` címet az új `.webp`-re irányítani, és a régi hivatkozások elromlanának.

A javítás egy blokk az oldal nginx-konfigurációjába. A Tester fülön ugyanez kimásolható, az oldalad valódi feltöltési útvonalával:

```nginx title="nginx – az oldal server blokkjába"
location ^~ /wp-content/uploads/ {
    location ~* \.(?:jpe?g|png|gif|bmp|tiff?)$ {
        expires max; access_log off; log_not_found off;
        add_header Cache-Control "public";
        try_files $uri /index.php$is_args$args;
    }
    location ~* \.(?:css|js|ico|svg|woff2?|ttf|eot|webp|avif|mp4|webm|pdf)$ {
        expires max; access_log off; log_not_found off;
        add_header Cache-Control "public";
        try_files $uri =404;
    }
    location ~* \.php$ { deny all; }
    try_files $uri =404;
}
```

Prefix (`^~`) `location` kell, mert egy sima regex-blokk alulmaradna a korábbi statikusfájl-szabályokkal szemben. Utána töltsd újra a webszervert, ürítsd a CDN gyorsítótárát, és a Tester fülön kattints a **Tesztek újrafuttatása** gombra.

> **Csak végszükség esetén**
>
> Parancssorból a `--skip-redirect-check` kapcsolóval a futás javítás nélkül is elindul, de ilyenkor a régi kép-URL-ek 404-et adnak.

## Szerver

| Amit látsz | Ok | Mit tegyél |
|---|---|---|
| Tester: a táblaszintű zárolás megakaszthatja az oldalt | A táblák MyISAM motorúak. | Mentés után `ALTER TABLE <tábla> ENGINE=InnoDB` (a Tester kimásolható parancsot ad). |
| Tester: „WebP bélyegkép-támogatás: nem támogatott” | A szerver képszerkesztője (Imagick/GD) nem tud WebP-t. | Kérj a tárhelyszolgáltatótól WebP-képes Imagicket vagy GD-t; addig ne indíts tömeges futást. |
| Tester: AVIF nem támogatott | AVIF kimenetnél a szerver nem tud AVIF bélyegképet készíteni. | Állítsd a formátumot WebP-re, vagy frissíttesd a képszerkesztőt. |
| Tester: a szerver nem éri el saját magát | A háttérfeladatok nem indulnak maguktól. | Tartsd nyitva a Bulk fület, vagy futtasd parancssorból: `wp lw-img optimize --all`. |
| A tömeges futás lassan halad vagy áll | A WP-Cron csak látogatáskor fut. | `wp lw-img optimize --all`, vagy rendszer-cron. |
| A bővítmény nem kapcsolható be | WordPress 6.6 vagy PHP 8.0 alatti verzió. | Frissíts WordPress 6.6+ és PHP 8.0+ verzióra. |

## Képek

| Amit látsz | Ok | Mit tegyél |
|---|---|---|
| „Kihagyva — a konvertált X lenne az eredeti Y helyett” | A forrás már erősen tömörített, a WebP nagyobb lenne. | Ez helyes működés: az eredeti marad. Más szinten: `wp lw-img requeue --skipped`, majd `--level=aggressive`, vagy a kép szerkesztőoldalán újraoptimalizálás. |
| „Kihagyva”, `file missing` | A fájl nincs a lemezen. | A csatolmány hibás; nézd meg a Médiatárban. |
| Tester: más optimalizáló bővítmény is aktív | Két optimalizáló fut egyszerre. | Kapcsold ki az egyiket; két optimalizáló ugyanazon a médiatáron dupla konvertálást és elpazarolt keretet okoz. |
| Nem látszik az intelligens vágás | Négyzetes kép négyzetes méretre (nincs mit vágni), ki van kapcsolva az automatikus konvertálás, vagy a rendszer-cron még nem futott. | Meglévő képekre: `wp lw-img smartcrop <id>` vagy `--all`. |

Ha elakadtál, írj nekünk: [support@hellowp.io](mailto:support@hellowp.io).