Node.js Puppeteer를 사용하여 서버에서 "Chrome을 찾을 수 없음" 및 캐시 경로 문제 해결

해결 방법 1: Apache 사용자에 대한 올바른 권한으로 Chrome 설치

접근 방식: www-data 사용자를 위해 Puppeteer를 설치하고 구성하기 위한 Node.js 백엔드 스크립트.

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);
    }
})();

솔루션 2: 환경 변수 및 경로 설정으로 Puppeteer 구성

접근 방식: Puppeteer의 캐시 경로에 대한 환경 변수를 사용하는 백엔드 구성을 위한 Node.js 스크립트

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);
    }
})();

솔루션 3: 단위 테스트 Puppeteer 캐시 및 실행 기능

접근 방식: Puppeteer 캐시 디렉터리 설정 및 브라우저 시작 기능을 검증하기 위한 Node.js 단위 테스트

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 및 Chrome 구성에 대해 자주 묻는 질문(FAQ)

1. Puppeteer가 내 서버에서 Chrome을 찾을 수 없는 이유는 무엇입니까?
2. 이는 일반적으로 기본값으로 인해 발생합니다. cache path Chrome의 경우 "www-data" 사용자는 액세스할 수 없습니다. 다음과 같은 공유 디렉터리를 사용하도록 Puppeteer를 구성해 보세요. /var/www/.cache/puppeteer.
3. Puppeteer에 대한 사용자 정의 캐시 경로를 어떻게 설정합니까?
4. 다음을 정의하여 사용자 정의 캐시 경로를 설정할 수 있습니다. process.env.PUPPETEER_CACHE 환경 변수를 지정하고 스크립트를 실행하는 모든 사용자가 액세스할 수 있는 디렉터리를 가리킵니다.
5. "샌드박스 없음"은 무엇을 의미하며, 왜 필요한가요?
6. 사용하여 args: ['--no-sandbox'] 옵션은 Chrome의 샌드박스 모드를 비활성화하여 특히 루트가 아닌 사용자의 서버 환경에서 권한 문제를 방지할 수 있습니다.
7. Puppeteer에 Chrome이 올바르게 설치되었는지 어떻게 확인하나요?
8. 다음을 실행하여 설치를 확인할 수 있습니다. npx puppeteer browsers install Apache 설정의 "www-data"와 같이 Puppeteer 스크립트를 실행할 동일한 사용자 아래에 있습니다.
9. 각 배포에 대한 캐시 경로 설정을 자동화할 수 있나요?
10. 예, 다음과 같은 명령을 사용하는 배포 파이프라인에 설정 스크립트를 추가하면 됩니다. fs.mkdirSync 캐시 생성 및 npx puppeteer browsers install 크롬 설치를 위해
11. 프로덕션 서버에서 Chrome 샌드박스를 비활성화해도 안전합니까?
12. 샌드박스를 비활성화하면 권한 문제가 해결될 수 있지만 일반적으로 보안이 약간 저하되므로 필요한 경우에만 권장됩니다. 안전한 환경을 위해 가능하다면 대안을 찾아보세요.
13. Puppeteer에서 Chrome을 실행하려면 어떤 권한이 필요합니까?
14. Puppeteer는 특히 기본 위치가 아닌 위치로 설정된 경우 구성에 지정된 캐시 및 사용자 데이터 디렉터리에 대한 읽기 및 쓰기 액세스 권한이 필요합니다.
15. Puppeteer에서 Chrome 대신 다른 브라우저를 사용할 수 있나요?
16. 예, Puppeteer는 Brave와 같은 다른 Chromium 기반 브라우저를 지원하며 Firefox는 부분적으로 지원됩니다. 그러나 스크립트 요구 사항과의 호환성을 확인하세요.
17. 설정 후 Puppeteer가 올바르게 구성되었는지 어떻게 확인합니까?
18. 캐시 디렉터리의 존재 여부를 확인하고 Puppeteer를 사용하여 Chrome 실행을 확인하는 단위 테스트를 실행하면 모든 것이 올바르게 구성되었는지 확인하는 데 도움이 됩니다.
19. 로컬 개발에서는 왜 이 오류가 발생하지 않나요?
20. 로컬 설정에서 현재 사용자는 기본 캐시 경로에 직접 액세스할 수 있는 반면, 서버에서는 Apache 사용자 "www-data"가 특정 구성 없이 일부 리소스에 액세스하지 못할 수 있습니다.
21. Puppeteer를 구성하는 데 필수적인 환경 변수는 무엇입니까?
22. 주요 환경 변수는 다음과 같습니다 PUPPETEER_CACHE 캐시 경로를 설정하고 선택적으로 PUPPETEER_EXECUTABLE_PATH 맞춤 Chrome 바이너리 위치를 지정합니다.

Puppeteer의 Chrome 오류를 해결하기 위한 주요 단계 마무리

Puppeteer에서 "Chrome을 찾을 수 없습니다" 오류가 발생하는 개발자의 경우 Chrome에 대한 캐시 경로와 실행 권한을 조정하는 것이 필수적입니다. 환경 변수와 같은 명령을 사용하여 설정 인형극 캐시 그리고 구성 인수: ['--샌드박스 없음'] 다양한 사용자 계정에 걸쳐 안정적인 액세스를 보장합니다. 🖥️

준비, 프로덕션 또는 다른 공유 서버에서 설정하는 경우 단위 테스트를 통해 구성을 확인하면 강력한 보증 계층이 추가됩니다. 이러한 단계를 통해 Puppeteer는 Chrome을 원활하게 찾고 스크립트를 안정적으로 실행할 수 있으므로 중단 없이 브라우저 작업을 자동화할 수 있습니다. 🛠️