A "Nem található Chrome" és a gyorsítótár-útvonal-problémák javítása a kiszolgálón a Node.js Puppeteer segítségével

A Puppeteer kihívásainak leküzdése Node.js és Laravel szerverkörnyezetben

Amikor helyi fejlesztési beállításról éles kiszolgálóra váltunk, gyakran előfordulnak váratlan konfigurációs problémák. Az egyik ilyen probléma, amely különösen frusztráló lehet, amikor a Node.js script segítségével Bábjátékos hibaüzenetet küld: "Nem található a Chrome." Ez általában akkor fordul elő, ha egy Laravel által vezérelt szkriptet futtat egy Apache kiszolgálófiók alatt, például „www-data”. 🖥️

Egy helyi gépen a Laravel-szkriptek az aktuális felhasználó fiókja alatt futnak le, ami azt jelenti, hogy az összes kapcsolódó csomóponti folyamat az adott felhasználó konfigurációját követi. Egy szerveren azonban az engedélyek és elérési utak megváltoznak, ami bonyodalmakhoz vezet a Chrome bináris Puppeteer által használt bináris megtalálásában. Ez gyakori kihívás a fejlesztők számára, mivel minden környezetnek megvannak a sajátosságai és követelményei.

A hiba mögött meghúzódó egyik fő probléma gyakran a rosszul konfigurált vagy elérhetetlen gyorsítótár elérési útja a Chrome telepítéséhez. Bár a Chrome for Puppeteer kézi telepítése segíthet, ez nem mindig elegendő a probléma megoldásához. Sok fejlesztő úgy találta, hogy a rendszerszintű engedélyek megfelelő konfigurációja kulcsfontosságú a Puppeteer zökkenőmentes futtatásához a szerveren.

Ebben a cikkben leírjuk, hogyan kezeljük ezt a hibát, megvizsgáljuk, miért fontos a gyorsítótár-útvonal konfigurációja, és gyakorlati megoldásokat osztunk meg. 🛠️ Néhány egyszerű beállítással megbízhatóan futtathatja Puppeteer szkriptjeit szerverkörnyezetén.

A Puppeteer gyorsítótár-útvonal-problémák megértése és megoldása a Node.js-ben kiszolgálón

Az előző szakaszban található szkriptek azt a kritikus célt szolgálják, hogy segítsenek a Puppeteernek megtalálni a telepített Chrome böngészőt a szerveren, különösen akkor, ha a Node.js szkriptet egy másik felhasználói fiók (például „www-data” az Apache alatt) futtatja. A hiba megjelenésének egyik fő oka az, hogy a Puppeteer az alapértelmezett gyorsítótár-útvonalon keresi a Chrome-ot, amely gyakran felhasználóspecifikus. Amikor a Node-szkriptet egy Apache-felhasználó hajtja végre, nem fér hozzá az aktuális felhasználó saját mappájában található gyorsítótár-könyvtárhoz. Ez a beállítás alternatív útvonal beállítását teszi lehetővé, mint pl /var/www/.cache/puppeteer, elengedhetetlen ahhoz, hogy a Chrome a futó felhasználótól függetlenül elérhető legyen. A megfelelő jogosultságokkal rendelkező könyvtár létrehozásával és a Puppeteer gyorsítótárának összekapcsolásával lehetővé tesszük, hogy az Apache alatt futó Puppeteer folyamat megbízhatóan megtalálja a Chrome böngészőt.

A szkriptek egyik első lépése a gyorsítótár-könyvtár létezésének biztosítása a használatával fs.mkdirSync a rekurzív opcióval. Ez garantálja, hogy minden szükséges szülőkönyvtár egy lépésben létrejön. A könyvtár létrehozása után a szkript beállítja a BÁBŐR-GYORSÍTÓ környezeti változó a Chrome telepítésének elérési útjára. Ez a környezeti változó kritikus fontosságú, mert felülírja a Puppeteer alapértelmezett gyorsítótár-útvonalát, biztosítva, hogy mindig a kijelölt szerverbarát útvonalon nézzen, nem pedig egy felhasználóspecifikus útvonalon. Például, ha egy átmeneti kiszolgálón dolgozik, és biztosítani szeretné, hogy a Puppeteer több fiókban is konzisztensen működjön, a környezeti változó megosztott helyre történő beállítása megakadályozza a hiányzó végrehajtható fájlokkal kapcsolatos hibákat.

A Puppeteer elindításakor ezekben a szkriptekben megadjuk a végrehajtható elérési út paramétert a Chrome bináris fájl közvetlen eléréséhez. Ezzel elkerülhető, hogy a Puppeteer több könyvtárban keressen, ami bizonyos engedélyek esetén meghiúsulhat. A szkriptekben található másik hasznos parancs az args: ['--no-sandbox'], szerverkörnyezetekben gyakran szükséges argumentum. Az alapértelmezés szerint engedélyezett sandbox mód néha zavarhatja a nem root felhasználókat, vagy korlátozhatja az engedélyeket bizonyos szerverkonfigurációkban. Ennek az argumentumnak a hozzáadásával lehetővé tesszük, hogy a Puppeteer elindítsa a Chrome-ot a sandbox nélkül, ami számos, az engedélyekkel kapcsolatos hibát megold a Linux szerverkörnyezetekben. 🖥️

Végül, hogy biztosítsuk a megoldás megbízható működését, egységteszteket biztosítottunk. Ezek a tesztek olyan parancsokat használnak, mint fs.rmdirSync a gyorsítótár-könyvtár visszaállításához, biztosítva a tiszta oldalt a tesztek futtatása előtt, amelyek ellenőrzik a szkript működését. Ezenkívül a teszt ellenőrzi a sikeres böngészőindításokat azáltal, hogy ellenőrzi, hogy a Puppeteer megtalálja-e a Chrome-ot a megadott útvonalon. Ez elengedhetetlen az automatizált telepítésű kiszolgálók számára, mivel megerősíti, hogy a böngésző konfigurációja éles környezetben kézi beállítások nélkül is működik. Folyamatos integrációs beállítás esetén például ezek a tesztek lefuthatnak minden alkalommal, amikor kódot telepítenek, így a fejlesztők biztosak lehetnek abban, hogy a Puppeteer konfigurációja sértetlen, megelőzve a nem kívánt meglepetéseket élő környezetben. 🛠️

const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

// Ensure the cache directory exists with appropriate permissions
function ensureCacheDirectory() {
    if (!fs.existsSync(path)) {
        fs.mkdirSync(path, { recursive: true });
        console.log('Cache directory created.');
    }
}

// Launch Puppeteer with a custom cache path
async function launchBrowser() {
    ensureCacheDirectory();
    const browser = await puppeteer.launch({
        headless: true,
        executablePath: '/usr/bin/google-chrome-stable',
        userDataDir: path,
    });
    return browser;
}

// Main function to handle the process
(async () => {
    try {
        const browser = await launchBrowser();
        const page = await browser.newPage();
        await page.goto('https://example.com');
        console.log('Page loaded successfully');
        await browser.close();
    } catch (error) {
        console.error('Error launching browser:', error);
    }
})();

const puppeteer = require('puppeteer');
require('dotenv').config();

// Load cache path from environment variables
const CACHE_PATH = process.env.PUPPETEER_CACHE_PATH || '/var/www/.cache/puppeteer';
process.env.PUPPETEER_CACHE = CACHE_PATH;

// Ensure directory exists
const fs = require('fs');
if (!fs.existsSync(CACHE_PATH)) {
    fs.mkdirSync(CACHE_PATH, { recursive: true });
}

// Launch Puppeteer with environment-based cache path
async function launchBrowser() {
    const browser = await puppeteer.launch({
        headless: true,
        args: ['--no-sandbox'],
        executablePath: '/usr/bin/google-chrome-stable',
    });
    return browser;
}

(async () => {
    try {
        const browser = await launchBrowser();
        console.log('Browser launched successfully');
        await browser.close();
    } catch (error) {
        console.error('Launch error:', error);
    }
})();

const { exec } = require('child_process');
const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

describe('Puppeteer Configuration Tests', () => {
    it('should create cache directory if missing', (done) => {
        if (fs.existsSync(path)) fs.rmdirSync(path, { recursive: true });
        exec('node setupScript.js', (error) => {
            if (error) return done(error);
            expect(fs.existsSync(path)).toBe(true);
            done();
        });
    });

    it('should launch Puppeteer successfully', async () => {
        const browser = await puppeteer.launch({
            headless: true,
            executablePath: '/usr/bin/google-chrome-stable',
            userDataDir: path,
        });
        expect(browser).toBeDefined();
        await browser.close();
    });
});

Puppeteer és Chrome Path hibák megoldása többfelhasználós környezetekben

Az egyik kihívás a használat során Bábjátékos szerver környezetben biztosítja a megfelelő gyorsítótár elérési útja Chrome-hoz, különösen akkor, ha a szkript egy másik felhasználói fiók, például az Apache „www-data” alatt fut. Ez a beállítás gyakran bonyolítja a konfigurációt, mivel előfordulhat, hogy az alapértelmezett Puppeteer gyorsítótár elérési útja nem érhető el a „www-data” fiók számára. Ha a Puppeteer nem találja meg a Chrome bináris fájlt, az gyakran a „Nem található Chrome” hibaüzenetet eredményezi, még akkor is, ha a Chrome korábban telepítve volt. A gyorsítótár elérési útjának manuális konfigurálása vagy a környezeti változók beállítása megoldhatja ezt a problémát azáltal, hogy biztosítja, hogy a Puppeteer egy olyan könyvtárban keressen, amely megosztott a felhasználók között, mint pl. /var/www/.cache/puppeteer.

Egy másik szempont, amelyet meg kell fontolni, konkrét indítási argumentumok beállítása a Puppeteer számára szerverkörnyezetben. Például a Chrome sandbox letiltása a következővel: args: ['--no-sandbox'] segít elkerülni az engedélyekkel kapcsolatos problémákat a Linux-kiszolgálókon, amelyek nem mindig kezelik jól a sandboxot a nem root felhasználók számára. Ez a beállítás az egyéni végrehajtható útvonal megadásával együtt javítja a Puppeteer kompatibilitását a szerverkörnyezetekkel. Helyi beállítás esetén előfordulhat, hogy nem találkozik ezekkel a problémákkal, mert a Puppeteer az aktuális felhasználó engedélyeivel fut, de éles környezetben a szigorúbb "www-adat" felhasználó nem fér hozzá bizonyos erőforrásokhoz, kivéve, ha kifejezetten konfigurálva vannak.

Végül, amikor a parancsfájlokat megosztott vagy éles környezetben telepíti, célszerű automatizálni ezeket a konfigurációkat. Automatikus lépések, mint például a gyorsítótár elérési útjának beállítása és a Chrome telepítése olyan paranccsal, mint pl npx puppeteer browsers install biztosítja, hogy minden telepítés készen áll a Puppeteer kézi beavatkozás nélküli futtatására. Ezen túlmenően, ha teszteket ad hozzá annak ellenőrzésére, hogy a Chrome megfelelően indul-e el, megelőzheti a hibás konfigurációk által okozott leállásokat. Ezek a módosítások elengedhetetlenek egy stabil környezet kialakításához, ahol a Puppeteer az elvárásoknak megfelelően működik, függetlenül a szkriptet futtató felhasználói fióktól. 🛠️