# Hibaelhárítás

> A leggyakoribb Google Drive hibaüzenetek, jelentésük és a javításuk.

## Általános teendők

- Jelentkezz ki a Google Drive-ból, majd be újra: **All-in-One WP Migration → Google Drive Settings**.
- Állítsd le a Drive-szinkronizálást és a Drive-hoz kapcsolódó más alkalmazásokat.
- Korlátátlépési hibák után várj 5 percet.

> **Megjegyzés**
>
> A **Google Drive Settings** oldal felirata és a bővítmény saját szövegei angolul jelennek meg, ezért a hibaüzenetek is angolul látszanak.

## A bővítmény hibaüzenetei

| Hibaüzenet | Jelentés | Megoldás |
|---|---|---|
| „Invalid Credentials” | A bővítmény nem tud kapcsolódni a Drive-hoz. | Jelentkezz ki és be újra a Google Drive Settings oldalon. |
| „The user does not have sufficient permissions for file” | A bővítmény nem fér hozzá a fájlhoz vagy mappához. | Ellenőrizd, hogy a fiókod eléri-e. Ha igen, vagy a fájl már a Drive-on van, jelentkezz ki és be újra. |
| „Cannot be used within the domain” | A céges domain tiltja a bővítmény hozzáférését a Drive-hoz. | Ellenőrizd, hogy a domainnel bejelentkezve eléred-e a Drive-ot, vagy kérdezd a domain adminisztrátorát. |
| „File not found” | A bővítmény nem találja a fájlt vagy mappát. | Nézd meg, hogy létezik-e és elérhető-e a Drive-on. |
| „Backend Error” | Váratlan hiba a Drive oldalán. | Próbáld újra, majd jelentkezz ki és be. |
| „Bad Request” | A bővítmény nem tud kapcsolódni a Drive-hoz. | Jelentkezz ki és be újra. |
| „User Rate Limit Exceeded” / „Rate Limit Exceeded” | Túl sok API-hívás ment a Drive-fiókodból. | Várj 5 percet, és állítsd le a szinkronizálást és a kapcsolódó alkalmazásokat. |
| „Sharing Rate Limit Exceeded” | A fiók elérte a megosztási korlátját, gyakran e-mailek vagy nyilvánosan megosztott dokumentumok miatt. | Mentés és migrálás közben ne küldj sok e-mailt, és vedd el a jogosultságokat a nyilvános fájlokról. |
| „The user has not granted access to the file” | A bővítménynek nincs jogosultsága a fájlhoz. | Ellenőrizd a hozzáférést, ha kell, jelentkezz ki és be. |
| „Too Many Requests” | Túl sok kérés érkezett a fiókodra, például nyilvános megosztás vagy más alkalmazások miatt. | Állítsd le a Drive-ot használó többi alkalmazást. |

## HTTP-hibakódok

A Google Drive kiszolgálója az alábbi HTTP-kódokkal jelezheti, ha egy kérés nem sikerült.

| Kód | Név | Jelentés és teendő |
|---|---|---|
| 400 | Hibás kérés | Hiányzó vagy érvénytelen mező, vagy ütköző mezők. Előfordul, ha egy Drive-elemhez kétszer adnál ugyanazt a szülőt, vagy a szülő hozzáadásával kör keletkezne a mappafában. |
| 401 | Nincs jogosultság | Lejárt vagy érvénytelen hozzáférési token. Frissítsd a tokent; ha nem megy, jelentkezz ki és be a bővítményben. |
| 402 | Fizetés szükséges | A folytatáshoz fizetni kell a termékért. |
| 403 | Tiltott | A kérés érvényes, de a kiszolgáló elutasítja: hiányozhat a jogosultság, vagy valamilyen fiók kell hozzá. |
| 404 | Nem található | Nincs olvasási jogod a fájlhoz, vagy nem létezik. Kérj hozzáférést a fájl tulajdonosától. |
| 405 | A módszer nem engedélyezett | Az erőforrás nem engedi a kérésben használt HTTP-módszert. |
| 406 | Nem elfogadható | A szolgáltatás nem támogatja az `Accept` fejlécben kért formátumot. |
| 407 | Proxy-hitelesítés szükséges | Előbb a proxyn kell hitelesítenie magát a kliensnek. |
| 408 | Kérés időtúllépés | A kiszolgáló nem kapta meg időben a kérést. Később ismételd meg változtatás nélkül. |
| 409 | Ütközés | A jelenlegi állapot ellentmond a kérésnek, ezért nem dolgozható fel. |
| 410 | Megszűnt | Az erőforrás már nem érhető el a kiszolgálón. |
| 411 | Hossz szükséges | A kérésnek `Content-Length` fejléc kell. |
| 412 | Előfeltétel sikertelen | A kiszolgáló nem teljesíti a kérő egyik előfeltételét. |
| 413 | Túl nagy kérés | A kérés mérete meghaladja a megengedett legnagyobbat. |
| 414 | Túl hosszú URI | A megadott URI túl hosszú a kiszolgálónak. |
| 415 | Nem támogatott médiatípus | A szolgáltatás nem támogatja a kérés tartalomtípusát. |
| 416 | A kért tartomány nem teljesíthető | A megadott bájttartomány érvénytelen vagy nem elérhető. |
| 417 | Elvárás sikertelen | A kiszolgáló nem tudja teljesíteni az `Expect` fejléc követelményeit. |
| 429 | Túl sok kérés | Rövid idő alatt túl sok kérés ment. Várj, és próbáld újra. |
| 500 | Belső szerverhiba | Váratlan hiba a kérés feldolgozásakor. Próbáld újra később. |
| 501 | Nincs megvalósítva | A kért funkciót a kiszolgáló nem valósítja meg. |
| 502 | Hibás átjáró | Az átjáró vagy proxy érvénytelen választ kapott a felsőbb kiszolgálótól. |
| 503 | A szolgáltatás nem elérhető | Átmeneti állapot; kis várakozás után próbáld újra. |
| 504 | Átjáró időtúllépés | Az átjáró vagy proxy nem kapott időben választ a felsőbb kiszolgálótól. |
| 505 | A HTTP-verzió nem támogatott | A kiszolgáló nem támogatja a kérésben használt HTTP-protokollverziót. |

## Google Drive API hibák

| Hiba | Jelentés | Megoldás |
|---|---|---|
| „Daily Limit Exceeded” | A projekt elérte az API ingyenes napi korlátját. | Kérj nagyobb kvótát. |
| „User Rate Limit Exceeded” | A felhasználónkénti korlát betelt. | Várj, és próbáld újra. |
| „Sharing Rate Limit Exceeded” | A megosztási korlát betelt, gyakran az e-mailkorláttal függ össze. | Sok fájl megosztásakor ne küldj e-mailt. Domain-felhasználóknál sok kérésnél érdemes delegált jogosultságú szolgáltatásfiókot használni. |
| „The user does not have sufficient permissions for file” | Nincs írási jogod, a bővítmény mégis módosítani próbálja a fájlt. | Kérj írási jogot a fájlhoz. |
| „… cannot be used within the authenticated user's domain” | A domain szabályzata tiltja az alkalmazás hozzáférését. | A domain nem engedélyezi az alkalmazást: a domain adminisztrátora tud segíteni. |
| „Rate Limit Exceeded” | Elérted a Drive API legnagyobb kérésgyakoriságát; a korlát a kérés típusától függ. | Várj, és próbáld újra. |
| „The user has not granted the app … access to the file …” | A kérő alkalmazás nincs a fájl hozzáférési listáján: a felhasználó sosem nyitotta meg a fájlt ezzel az alkalmazással. | Add meg a hozzáférést a fájlhoz, vagy jelentkezz ki és be. |

## cURL-hibák

Kapcsolódási hibánál a bővítmény cURL-hibakódot is mutathat. Az alábbi lista a teljes kódkészletet tartalmazza; a hálózati hibáknál (6, 7, 28, 35, 52, 55, 56, 60) érdemes kezdeni.

### Gyakori kapcsolódási hibák

| Kód | Jelentés |
|---|---|
| 5 | A proxy neve nem oldható fel. |
| 6 | A távoli gép neve nem oldható fel. |
| 7 | A kapcsolódás a géphez vagy proxyhoz nem sikerült. |
| 22 | A kiszolgáló 400-as vagy nagyobb HTTP-kódot adott, és a hibán megállás be van kapcsolva. |
| 23 | A fogadott adat helyi fájlba írása nem sikerült. |
| 26 | Hiba egy helyi fájl olvasásakor. |
| 27 | Nincs elég memória (súlyos hiba). |
| 28 | A művelet időtúllépésbe futott. |
| 35 | Az SSL/TLS kézfogás nem sikerült (tanúsítvány, jelszó és hasonló okok). |
| 47 | Túl sok átirányítás. |
| 52 | A kiszolgáló semmit nem küldött vissza. |
| 55 | Hálózati adat küldése sikertelen. |
| 56 | Hálózati adat fogadása sikertelen. |
| 58 | Hiba a helyi kliens-tanúsítvánnyal. |
| 59 | A megadott titkosítás nem használható. |
| 60 | A kiszolgáló SSL-tanúsítványát vagy SSH-ujjlenyomatát elutasították. |
| 61 | Ismeretlen átviteli kódolás. |
| 63 | A legnagyobb fájlméretet túllépték. |
| 77 | Hiba az SSL CA-tanúsítványfájl olvasásakor (útvonal vagy jogosultság). |
| 80 | Az SSL-kapcsolat lezárása nem sikerült. |
| 82, 83 | A visszavonási lista (CRL) fájlja nem tölthető be, illetve a kibocsátó-ellenőrzés sikertelen. |
| 90, 91 | A rögzített nyilvános kulcs nem egyezik, illetve az SSL-állapotellenőrzés hibát adott. |
| 92 | Adatfolyam-hiba a HTTP/2 rétegben. |

Az `0` kód: nincs hiba.

### Belső és ritka hibák

| Kód | Jelentés |
|---|---|
| 1 | A libcurl nem támogatja az URL protokollját. |
| 2 | A korai inicializálás meghiúsult (belső vagy erőforrás-hiba). |
| 3 | Hibás formátumú URL. |
| 4 | A kért funkció nincs beépítve a libcurlbe; újraépített libcurl kell. |
| 8, 11, 13, 14, 15 | Az FTP-kiszolgáló értelmezhetetlen vagy hibás választ adott (a kód nem csak FTP-nél fordul elő). |
| 9 | Hozzáférés megtagadva az URL-ben megadott erőforráshoz. |
| 10, 12, 30, 31 | Aktív FTP-munkamenet, PORT vagy REST parancs hiba. |
| 16 | Hiba a HTTP/2 keretezésben. |
| 17 | Hiba az átviteli mód (bináris vagy ASCII) beállításakor. |
| 18 | Részleges fájl érkezett. |
| 19 | Az FTP `RETR` parancs hibás választ adott, vagy nulla bájtos az átvitel. |
| 21 | Egy egyedi „QUOTE” parancs hibát adott. |
| 25 | A feltöltést nem sikerült elindítani. |
| 33 | A kiszolgáló nem támogatja a tartománykéréseket. |
| 34 | Belső zavar a HTTP POST-nál. |
| 36 | A letöltés nem folytatható, mert a kezdőpont kívül esik a fájlon. |
| 37 | A `FILE://` címen megadott fájl nem nyitható meg. |
| 38, 39, 62 | LDAP-hiba (kötés, keresés, érvénytelen URL). |
| 41 | Egy szükséges zlib-függvény nem található. |
| 42 | Egy visszahívás megszakította a műveletet. |
| 43 | Belső hiba: rossz függvényparaméter. |
| 45 | A megadott kimenő hálózati interfész nem használható. |
| 48 | A libcurl nem ismeri a megadott opciót. |
| 49 | Hibás formátumú telnet-opció. |
| 53, 54, 66 | Az SSL titkosítómotor nem található, nem állítható be, vagy nem indul el. |
| 64 | A kért FTP SSL-szint nem sikerült. |
| 65 | Az adat visszatekerése újraküldéshez nem sikerült. |
| 67 | A távoli kiszolgáló megtagadta a bejelentkezést. |
| 68, 69, 71, 72, 74 | TFTP-hiba (nem található, jogosultság, érvénytelen művelet, ismeretlen azonosító). |
| 70 | Elfogyott a hely a kiszolgálón. |
| 73 | A fájl már létezik, és nem íródik felül. |
| 75, 76 | Karakterkonverziós hiba. |
| 78 | Az URL-ben megadott erőforrás nem létezik. |
| 79 | Meghatározatlan hiba az SSH-munkamenetben. |
| 81 | A csatlakozó még nem áll készen küldésre vagy fogadásra; várni kell, és újra kell próbálni. |
| 84 | Az FTP-kiszolgáló nem érti a `PRET` parancsot vagy argumentumát. |
| 85, 86 | RTSP-sorszám vagy munkamenet-azonosító eltérés. |
| 87 | Az FTP fájllista nem értelmezhető. |
| 88 | A darabolt átvitel visszahívása hibát jelzett. |
| 89 | Csak belső használatú, a libcurl nem adja vissza. |
| 93 | Egy API-függvényt visszahíváson belülről hívtak meg. |
| 94 | Egy hitelesítő függvény hibát adott. |

A többi kód elavult, soha nem jelenik meg.

Ha az export SSL-hiba miatt áll le, kipróbálhatod a **Disable connecting to Google Drive via SSL (only if export is failing)** beállítást.


## Hiányzó PHP-bővítmények

A bővítmény belső függvényei három PHP-bővítményre épülnek. Ha a szerverről valamelyik hiányzik, hibaüzenetet kapsz. A megoldás mindháromnál ugyanaz: kérd meg a tárhelyszolgáltatódat, hogy telepítse a hiányzó bővítményt, vagy válassz másik tárhelyet.

| Bővítmény | Mire kell |
|---|---|
| **cURL** | Távoli webszolgáltatások elérése; az export és az import adatait ezzel dolgozza fel a bővítmény és a kiegészítői. |
| **libxml** | XML-dokumentumok értelmezése a PHP-ben; a bővítmény néhány belső függvénye használja. |
| **SimpleXML** | XML-adatok egyszerű kezelése; a bővítmény néhány belső függvénye igényli. |

## Üres képernyő a Google Drive-hoz kapcsolódáskor

Ha a Google Drive-hoz (vagy más felhőtárhelyhez) kapcsolódáskor üres képernyőt kapsz, az egyik ok a PHP **Suhosin** védelmi bővítménye lehet. A Suhosin a PHP-telepítések védelmi rendszere, és a GET-változók megengedett hosszát is korlátozza. A megoldás ennek a korlátnak az emelése.

1. Nyisd meg a PHP beállítófájlját (`php.ini` vagy `suhosin.ini`).
2. Keresd meg a `suhosin.get.max_value_length` sort (az alapérték 512).
3. Írd át 1024-re:

```ini
suhosin.get.max_value_length = 1024
```

4. Indítsd újra a PHP-t vagy a webszervert, majd próbálj újra csatlakozni.

Ha így sem működik, kérj segítséget a tárhelyszolgáltatódtól.